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INTRODUCTION:  SAP  PARAMETER  EDITOR  CSCI  DESCRIPTION 


1.1  BACKGROUND 


The  function  of  the  Semi-Automated  Forces  (SAP)  Segment  is  to  allow  a  single  operator  at 
a  SAP  workstation  to  control  a  large  number  of  vehicles  out  on  the  SIMNET  battlefield. 
The  SAP  Segment  runs  on  two  ha^waie  platforms,  the  workstation  conqiuter  and  the 
simulation  host  computer.  It  consists  of  three  CSCIs,  The  SAP  Parameter  Editor  CSCI 
and  the  SAP  Workstation  CSCI  which  run  on  the  workstation  ctxxiputer  and  the  SAP 
Simulation  Host  CSCI  which  runs  on  the  simulation  host  (Simhost)  computer.  The  SAP 
Parameter  Editor  is  the  con^xMient  which  is  used  to  reconfigure  the  SAP  and  its  operating 
characteristics  without  the  need  to  reprogram  it 


1.2  EXTERNAL  COMMUNICATIONS 

The  way  the  SAP  Parameter  Editor  communicates  with  itself  and  other  SAP  CSCIs  is 
shown  in  Figure  1.2-1. 


201  Ethernet 


Figure  1.2-1  Software  Interface  Organization 
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The  SAP  Parameter  Editor  CSCI  interfaces  with  the  SAP  Workstation  CSCI  [6.0]  and  the 
SAP  Simhost  CSCI  [8.0].  The  SAP  Parameter  Editor  receives  mouse  and  key^  jard  input 
from  the  Workstation  CSCI  and  sends  screen  information  to  the  workstation.  The 
Parameter  Editor  CSCI  retrieves  SAP  Parameter  Data  Piles,  updates  them,  and  stores  these 
files  via  the  Ethernet.  These  SAP  Parameter  Data  Piles  are  stored  on  the  SAP  Simhost 
computer.  Reference  the  Appendices  A.LA  SAP  SimHost 


1.3  INTERNAL  STRUCTURE 

The  functimi  of  the  Parameter  Editor  is  to  allow  a  user  to  modify  the  default  characteristics 
of  the  network  entities  under  his  control  in  a  consistant  and  straight  fcH^vard  manner.  The 
parameters  under  the  users  control  can  affect  vehicle's  capability  (Model  Editor),  a 
weapons  capability  (Weapons  Editor),  or  define  how  multiple  vehicles  interact  (Foimation 
Editor). 

The  parameters  available  for  alteration  on  the  Model  Editor  include  the  probability  the  the 
vehicle  will  hit  a  target  at  a  given  range  and  the  probability  that  the  vehicle  will  be  damaged 
by  Indirect  or  Direct  fire.  The  Weapons  Systems  Editor  allows  the  user  to  change 
parameters  such  as  effective  range  for  the  weapon.  The  Pormations  editor  allows  the  user 
to  update  the  fundamental  elements  of  various  multiple  vehicle  formations,  such  as  the  inter 
vehicle  distance  or  relative  angle  between  vehicles. 

The  structure  of  the  SAP  Parameter  Editor  CSCI  is  shown  in  Pigure  1.3-1. 


SAP  Parameter  Editor  CSCI  Structure 

The  SAP  Parameter  Editor  is  composed  of  three  top-level  CSCs: 

Model  Editor 
Weapons  Systems  Editor 
Pormations  Editor 


1.4  CONFIGURATION  AND  CONFIGURATION  MANAGEMENT 


The  SAP  Parameter  Editor  CSCI  and  the  SAP  Workstation  CSCI  are  written  in  LISP. 
SAP  Simulation  Host  CSCI  is  written  in  C.  The  SAP  Parameter  Edititor  runs  on 
Symbolics  3650  Series  Computers. 


The 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


1.5  TERMINOLOGY  AND  DOCUMENTATION 

The  following  documents  provide  additional  information  about  the  SAP  Segment; 

BBN  Report  No.  7025,  SIMNET  SEMI-AUTOMATED  PORCES  COMBINED 
ARMS  WORKSTATION  USERS  GUIDE 

BBN  Report  No.  73 10,  SIMNET  SEMI-AUTOMATED  PORCES  TECHNICAL 
OPERATIONS  MANUAL 

BBN  Report  No.  7311,  SIMNET  SEMI-AUTOMATED  PORCES  MODEL 
EDITOR  USERS  GUIDE 

BBN  Report  No.  7312,  SIMNET  SEMI-AUTOMATED  PORCES  WEAPONS 
SYSTEMS  EDITOR  USERS  GUIDE 

Perceptronics  PTR-4043- 17-0200,  SIMNET  SEMI-AUTOMATED  PORCES 
(Version  3.x)  PUNCTIONAL  SPECIPICATION 


Other  related  documents  are  listed  in  section  1.6  of  the  SAP  Workstation  CSCI  document. 
The  SAP  Workstation  CSCI  document  also  contains  a  number  of  sections  that  apply  to  the 
entire  SAP  Lisp  code.  These  sections  provide  important  information  relevant  to  the  SAP 
Parameter  Editor  CSCI.  Section  1.4  of  the  SAP  Workstation  CSCI  document  is  an  index 
to  all  the  SAP  files,  section  1.5  contains  notes  on  the  design  of  SAP  software,  including 
information  on  the  automatically  generated  definition  cross-reference  (section  1.5.1), 
section  1.7  is  a  glossary  of  SAP  terms,  and  section  1.8  is  a  master  index  of  SAP  Lisp 
definitions. 

The  SAP  Parameter  Editor  CSCI  enables  the  user  to  edit,  off-line,  the  parameters  of 
vehicles  and  other  SAP  objects.  The  user  does  not  need  to  know  programming,  nor  have 
any  knowledge  of  a  standard  text  editor,  in  order  to  make  changes  to  these  parameters.  The 
SAP  Parameter  Editor  CSCI  passes  the  edited  information  to  the  SAP  SimulatOT  Host  and 
Workstation  CSCIs  in  the  form  of  SAP  parameter  files. 
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2  CSC  DESCRIPTIONS 

The  SAP  Parameter  Editor  CSCI  contains  three  top  level  CSCs.  These  CSCs  are  editors 
that  enable  modification  of  various  SAP  data  files:  the  Model  Editor  CSC,  Weapons 
Systems  Editor  CSC,  and  Pormations  Editor  CSC. 


2 . 1  MODEL  EDITOR  CSC 

This  CSC  ctxitains  the  code  which  allows  the  curator  to  edit  detection  probabilities,  direct 
fire  hit  probability,  direct  fire  damage  probabilities,  and  indirect  fire  damage  probabilities. 
The  data  is  presented  in  graphical  and  tabular  disphys,  and  can  be  changed  in  either  form. 
Changes  can  be  undone  or  saved.  The  software  for  Ais  editor  is  found  in  the  file 
saf>interface>model-menu.lisp. 

This  CSC  edits  the  following  files  in  the  Simhost  directory  lusrlsc^configl : 

detection. lisp 
hitmodels.lisp 
tankdf.lisp 
tankjf.lisp 


The  Models  Editor  is  actually  a  multi-use  editor  for  5  different  kinds  of  data,  sharing  a 
common  thread: 

Hit  Model:  probability  that  a  weapon’s  shot  will  hit  a  target  versus  the  target's  distance,  as 
a  function  of  weapon  kind  and  target  attitude  (moving,  stationary,  or  hull  defilade). 

Ground  Detection  Model;  probability  of  seeing  a  vehicle  from  the  ground  versus  distance, 
as  a  function  of  arc  of  vision  and  target  attitude  (moving,  stationary,  or  hull  defilade). 

Air  Detection  Model:  probability  of  seeing  a  vehicle  from  the  air  versus  distance,  as  a 
function  of  arc  of  vision  and  target  attitude  (moving,  stationary,  or  hull  defilade). 

Direct  Eire  Damage  Model:  probability  of  damage  given  that  a  directly  fired  shot  has  hit  a 
vehicle  versus  angle  of  incidence,  as  a  function  of  kind  of  munition,  side,  structure  being 
hit,  and  degree  of  damage  (catastrophic,  mobility,  and  firepower). 

Indirect  Pire  Damage  Model:  probability  of  damage  due  to  indirect  fire  (e.g.:  near  miss  by  a 
bomb)  versus  distance,  as  a  function  of  kind  of  munition  and  degree  of  damage 
(catastrophic,  mobility,  and  firepower). 
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The  common  thread  is  the  probability  fiinctitMi,  which  the  editor  represents  both  as  an  XY 
graph  or  plot,  and  as  a  numerical  table.  Users  can  change  probability  functions  by 
manipulating  points  in  the  graph  representation  (deleting  inserting  and  moving  them),  or  by 
editing  numb^  in  the  table  representation.  The  resulting  changes  can  then  be  evaluated  for 
their  tactical  effects. 

This  editor  was  originally  conceived  for  Hit  data  only.  When  the  need  for  editing  detecticm 
data  became  i^}parent,  tte  editor  was  augmented  to  handle  it  Finally,  damage  data  editing 
capabilities  wa%  added.  The  software  is  in  tite  file  saf:inteiface;tiKxlel-menu.lisp. 

This  CSC  consists  of  the  following  CSUs: 

Parameters,  Globals,  and  Macros 
Graphing  code 

Graphics  manipulation  functirais 
Frame  and  screen  configurations 
Command  processor  commands 
Panes  and  their  presentations 
File  input/output  and  database  preparation 
High  level  functions 

A  description  of  each  of  these  units  follows.  Each  unit  is  located  in  the  file  following  a 
comment  header,  an  abbreviated  form  of  this  header  is  included  below,  in  brackets,  at  the 
beginning  of  each  section. 

2.1.1  Parameters,  Globals,  and  Macros 
[; ; ;  PARAMETERS  ] 

Contains  definitions  of  variables  used  globally  (mostly  within  the  Models  editor  code). 
Their  names  are  enclosed  in  asterisks  (*),  their  initial  values  are  specified,  and  most  have 
their  purpose  explained  by  a  brief  documentation  siring.  A  few  macros  of  genoal  utility  are 
also  defined  in  ^is  CSU. 

2.1.1.1  ♦OLD-SELECTION* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

HIGHLIGHT-SELECTION 

>saf>interface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>intcrface>model-menu.lisp 

SWITCH-HIGHLIGHT 

>saf>interface>model-menu.lisp 

None 
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2.1.1.2  *HULL-GRAPH* 


Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

CaUs: 

None 

Called  by: 

SET-CURRENT-MODEL 

Description; 

>saf>inteiface>model-menu.lisp 

CHANGE-MODE 

>sa£>interface>model-menu.lisp 

None 

2.1.1.3 

♦STATIONARY-GRAPH* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments; 

0 

Outputs: 

Calls: 

None 

Called  by: 

SET-CURRENT-MODEL 

Description: 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 

2.1.1.4 

♦MOVING-GRAPH* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

SET-CURRENT-MODEL 

Description: 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 
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2.1.1.5  •CATASTROPHIC-GRAPH* 


Type: 

Arguments; 
Ouqjuts: 
Calls; 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>interface>model-menu.iisp 

CHANGE-MODE 

>saf>inteiface>model-menu.lisp 

None 


2.1.1.6  ‘MOBILITY-GRAPH* 


Type: 

Ai^guments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>inteTface>model-menu.lisp 

None 


2.1.1.7  ‘FIREPOWER-GRAPH* 


>saf>interface>model-menu.lisp 
Type:  Parameter 

Arguments:  () 

Outputs: 

Calls:  None 

Called  by:  SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 
CHANGE-MODE 
>saf>interface>model-menu.lisp 
None 


Description: 
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2.1.1.8  •HULL-POINTS* 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>inteiface>model-menu.lisp 

REMEMBER-CURRENT-HIT-TABLE 

>saf>inteiface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-tnenu.lisp 

None 


2.1.1.9  *STATIONARY-POINTS* 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

REMEMBER-CURRENT-HIT-TABLE 

>saf>inteiface>nK)del-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>modeI-menu.lisp 

None 
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2.1.1.10  *MOVING.POINTS* 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

REMEMBER-CURRENT-HIT-TABLE 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 


2.1.1.11  *CATASTROPHIC.POINTS* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 


Description: 
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2.1.1.12  *MOBILITY.POINTS* 


Type; 

>saf>interface>model-menu.Usp 

Parameter 

Arguments: 

0 

Outputs; 

CaUs: 

None 

Called  by: 

SET-CURRENT-MODEL 

Description; 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.Usp 

CHANGE-MODE 

>saf>interface>model-menu.Usp 

None 

Type; 

>saf>interface>model-menu.lisp 

Parameter 

^guments: 

0 

Outputs; 

CaUs: 

None 

CaUed  by: 

SET-CURRENT-MODEL 

Description: 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 

2.1.1.14 

♦PART* 

Type; 

Arguments; 
Outputs; 
CaUs; 
Called  by; 


Description; 


>saf>interface>model-menu.lisp 

Paiameter 

0 

None 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-menu.lisp 

USER-SELECT-ASPECT 

>saf>interface>model-nienu.lisp 

None 
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2.1.1.15  *ASPECT* 


Type: 

Arguments: 
Oitputs: 
Calls: 
Called  by: 


Description: 


>saf>intcrface>model-menu.lisp 

Parameter 

0 

None 

PRESENT-DATA 

>saf>inteiface>model-menu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

USER-SELECT-ASPECT 

>saf>interface>iiK)del-menu.lisp 

None 


2.1.1.16  *TABLE.TYPE* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
TESTER) 


TESTER) 


>saf>interface>modeI-menu.lisp 

Parameter 

0 

None 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT 

No  Source  File  Record 

PRESENT-TABLE 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>intcrface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

WRITE-DETECTION-DATA-FILE 

>saf>interface>model-menu.lisp 

WRnE-CX)RRESPONDlNG-TABLE 

>saf>interface>modeI-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-inenu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-GROUND-DETECTION-DATA 
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Description: 


2.1.1.17 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


>saf>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model'menu.lisp 

USER-SELECT-MODEL 

>saf>interl:'ace>model'menu.lisp 

MAKE-GRAPH-GIVEN-POINTS 

>saf>interface>model'menu.lisp 

GRAPH-UNDO 

>saf>interface>modeI-menu.lisp 

REVERT-TO-FACrORY- VERSION 

>saf>inteiface>model-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>model-menu.lisp 

PRESENT-GRAPH 

>saf>interface>modeI-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-menu.lisp 

None 


♦MODE* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

(PRESENTATION-MOUSE-HANDLER  mSERT-POINT-l) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

(METHOD  ALTER-PROBABILITY  POINT) 

>saf>interface>modeI-menu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>inteiface>model-menu.lisp 

SELECT-AND-DRAG-UP-DOWN-POINT 

>saf>interface>modeI-menu.lisp 

CHANGE-MODE 

>saf>interface>tnodel-menu.lisp 

SWITCH-HIGHLIGHT 

>saf>interface>model-menu.lisp 

GO-BACK-TO-PREVIOUS-STEP 

>saf>interface>model-menu.lisp 

UPDATE-BACKTRACKING-CAPABILrrY 

>saf>interface>tnodel-menu.lisp 

SELECr-AND-DRAG-POINT 

>saf>interface>model-menu.lisp 

GET-POINT 

>saf>interface>model-mcnu  .li  sp 
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Description; 


(METHOD  ERASE-POINT-AND-LINES  POINT) 

>saf>interface>modeI-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model'menu.lisp 

ADD-NEW-POINT 

>saf>intet  lacomodel-menu.lisp 

RECXIRD-NEW-POINT 

>saf>interface>model-inenu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-UST 

>saf>inteiface>model-menu.lisp 

UPDATE-POINT-UST 

>saf>interface>model-menu.lisp 

nND-SURROUNDING-POINTS 

>saf>interface>model-menu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>inodel-inenu.lisp 

(METHOD  EXPUNGE  POINT) 

>saf>interface>model-menu.lisp 

DRAW-X-nCKS 

>saf>intetface>model-inenu.lisp 

GET-CURRENT-LINE-POINTS 

>saf>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

GIMME-VAR-NAME-OF-CURRENT-POINTS 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.Usp 

None 
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2.1.1.18  *WEAPON-NAME* 


>saf>interface>model-menu.lisp 
Type:  Parameter 

Arguments:  () 

OuQ)uts: 

Calls:  None 

CaUed  by:  PRESENT-DATA 

>saf>inteiface>model-menu.lisp 
SET-CURRENT-MODEL 
>st^>interface>model-menu.lisp 
REMEMBER-CURRENT-HIT-TABLE 
>saf>inteiface>model-menu.lisp 
REMEMBER-TABLE 
>saf>interface>model-menu.lisp 
READ-DIRECT-FIRE-DAMAGE-DATA 
>saf>interface>model-menu.lisp 
READ-INDIRECT-FIRE-DAMAGE-DATA-FROM-FILE 
>saf>inteTface>model-menu.lisp 
READ-INDIRECT-FIRE-DAMAGE-DATA 
>saf>interface>model-menu.lisp 
READ-AIR-DATA-FROM-FILE 
>saf>interface>model-menu.lisp 
READ-AIR-DETECnON-DATA 
>saf>interface>model-menu.lisp 
READ-GROUND-DATA-FROM-FILE 
>saf>interface>model-menu.lisp 
REAI>GROUND-DETECnON-DATA 
>saf>interface>model-menu.lisp 
READ-HTT-DATA-FILE 
>saf>interface>model-menu.lisp 
READ-HIT-DATA 
>saf>interface>model-menu.lisp 
USER-SELECr-ASPECT 
>saf>interface>model-menu.lisp 
GRAPH-UNDO 
>saf>interface>model-menu.lisp 
Description:  None 
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2.1.1.19 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


•PARAMETER-DISPLAY-PANE* 


>saf>interface>model-menu.lisp 

Variable 

0 

None 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1) 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

READ-DIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-INDIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-GROUND-DETECTION-DATA 

>saf>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model-menu.lisp 

SELECT-MODEDMENU 

>saf>interface>model-menu.lisp 

(METHOD  ALTER-PROBABILITY  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  COM-FIREPOWER-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-MOBILITY-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-CATASTROPmC-INTERNAL  MODEL-MENU) 
No  Source  File  Record 

(METHOD  COM-MOVING-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-STATIONARY-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-HULL-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-UNDaiND-INTERNAL  MODEL-MENU) 

No  Source  File  Record 
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Description: 


2.1.1.20 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


(METHOD  COM-SELECT-MODEL-IND-INTERNAL  MODEL- 
MENU) 

No  Source  File  Record 

(METHOD  COM-UNDO-DIR-INTERNAL  MODEl^MENU) 

No  Source  File  Record 

(METHOD  COM-SELECr-ASPECT-DIR-INTERNAL  MODEL- 
MENU) 

No  Source  File  Record 

(METHOD  COM-SELECT-MODEL-DIR-INTERNAL  MODEL- 
MENU) 

No  Source  File  Record 

(METHOD  COM-UNDO-INTERNAL  MODEl^MENU) 

No  Source  File  Record 

(METHOD  COM-SELECT-MODEL-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  TOP-LEVEL  MODEL-MENU) 

>saf>interface>model-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

SELECT-MODEl^MENU 

>saf>interface>model-menu.lisp 

None 


•TABULAR-DISPLAY-PANE* 


>saf>interface>model-menu.lisp 

Variable 

0 

None 

PRESENT-DATA 
>saf>interface>model-menu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 
>saf>interface>model-menu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>model-menu.lisp 

None 
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• 

2.1.1.21 

♦MODEL-FRAME* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

MAKE-DOCUMENTATION 

Description: 

>saf>interface>model-menu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 

>saf>interface>model-menu.lisp 

(METHOD  MAKE-INSTANCE  MODEL-MENU  AFTER) 

>saf>interface>model-inenu.lisp 

None 

2.1.1.22 

♦DISPLAY-LOGO-PANE* 

Type: 

>saf>interface>model-mcnu.lisp 

Variable 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

PRESENT-DATA 

• 

Description: 

>saf>interface>model-menu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 

>saf>interface>model-menu.lisp 

None 

2.1.1.23 

♦TABULAR-LOGO-PANE* 

Type: 

>saf>inteiface>model-menu.lisp 

Variable 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

PRESENT-DATA 

Description: 

>saf>interface>modeI-tnenu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 

>saf>interface>model-tnenu.lisp 

None 

• 
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2.1.1.24  *HIT-FILE-NAME* 


Type: 

Arguments: 

Ouqjuts: 

CaUs: 

CaUedby: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

WRITE-HIT-DATA 

>saf>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model-iiienu.lisp 

MAKE-HTTMODELS-DICnONARY 

>saf>interface>modcl-menu.lisp 

None 


2.1.1.25  *DETECTION.FILE-NAME* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

WRITE-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-GROUND-DETECTION-DATA 

>saf>interface>model-menu.lisp 

None 
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2. 1. 1.26  *INDIRECT.FIRE.DAMAGE.FILE.NAM  E* 


Type: 

Arguments: 
C)uq)uts: 
Calls: 
Called  by: 


Description: 


>saf>interface>modcl-inenu.lisp 

Parameter 

0 

None 

PRESENT-DATA 

>saf>inteiface>modei-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-inenu.lisp 

READ-INDIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

REVERT-TO-FACTORY-VERSION 

>sa£>iiiterface>inodel-inenu.lisp 

None 


2.1.1.27  *DIRECT-FIRE-DAMAGE.FILE-NAME* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

PRESENT-DATA 

>saf>inteiface>model-menu.lisp 

WRITE-DIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>intcrface>model-menu.lisp 

REVERT-TO-FACTORY-VERSION 

>saf>interface>model-menu.lisp 

None 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 
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2.1.1.28  *DF.VEHICLE* 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

GET-PLATFORM 

>saf>interface>model-menu.lisp 

WRITE-DIRECr-FIRE-DAMAGE-DATA-FILE 

>saf>interface>iTK)del-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf!>interface>model-menu.lisp 

None 


2.1.1.29  *IF-VEHICLE* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.Usp 

Parameter 

0 

None 

GET-PLATFORM 

>saf>interface>model-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

None 


2.1.1.30  *IND-FIR-TABLES* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

GATHER-INDIRECT-FIRE-DATABASE 

>saf>interface>model-menu  .lisp 

GATHER-DATABASE 

>saf>inteiface>model-menu.lisp 

WRITE-INDIRECr-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 
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MENU) 


Description: 


2,1.1.31 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


MENU) 


Description: 


READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-menu.lisp 

USER-SELECT-MODEL 

>saf>inteTface>model-menu.lisp 

(METHOD  COM-SELECT-MODEl^IND-INTERNAL  MODEL- 

No  Source  File  Record 

GRAPH-UNDO 

>saf>interface>model-inenu.lisp 

DRAW-X-TICKS 

>saf>inteiface>model-inenu.lisp 

None 


♦DIR-FIR-TABLES* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

GATHER-DIRECT-FIRE-DATABASE 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>interface>model-menu.lisp 

WRITE-DIRECr-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>interiace>model-menu.lisp 

USER-SELECT-ASPECT 

>saf>interface>model-menu.lisp 

USER-SELECT-MODEL 

>saf>interface>modeI-menu.lisp 

(METHOD  COM-SELECT-MODEUDIR-INTERNAL  MODEL- 

No  Source  File  Record 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-menu.lisp 

None 
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2.1.1.32 


Type: 

Arguments: 
C)uq)uts: 
Calls: 
Called  by: 


Description: 


2.1.1.33 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


E)escription: 


•HIT-TABLES* 


>saf>interface>model-inenu.lisp 

Variable 

0 

None 

REMEMBER-TABLE 

>saf>imeiface>model-menu.lisp 

GET-HIT-TABLE 

>saf>inteiface>model-iiienu.lisp 

GET-TABLE 

>saf>interface>modeI-menu.lisp 

WRITE-DETECnON-DATA-FILE 

>saf>inteiface>model'iiienu.lisp 

WRITE-HIT-DATA-FILE 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>model'menu.lisp 

REAEMjROUND-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model-menu.lisp 

USER-SELECT-MODEL 

>saf>interface>inodel-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

DRAW-X-nCKS 

>saf>interface>model-menu.lisp 

list  of  all  known  hit  table  defstructs 


•DIRECT-FIRE-DAMAGE-DATA* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

WRITE-DIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-inenu.lisp 

FETCH-DF-DATA 

>saf>interface>model-nienu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-inenu.lisp 

None 
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2.1.1.34 


Type: 

Arguments: 
Ou^uts: 
CaUs: 
Called  by: 


Description: 


2.1.1.35 


Type: 

Arguments: 

Outputs: 

Calls: 

CaUedby: 


Description: 


2.1.1.36 


Type: 

Arguments: 

Outputs: 

Calls: 


CaUedby; 


♦INDIRECT-FIRE-DAMAGE-DATA* 


>saf>inteiface>model-menu.Usp 

Parameter 

0 

None 

WRTIE-INDIRECr-FIRE-DAMAGE-DATA-FILE 

>saf>inteiface>nKxlel-menu.lisp 

FETCH-IF-DATA 

>saf>interface>model-menu.lisp 

READ-INDIRECr-FIRE-DAMAGE-DATA 

>saf>inteiface>model-inenu.lisp 

None 


TRUNCATE-TO-N-POSITIONS 


>saf>interface>model-menu.lisp 

Macro 

(NUMBER  N) 

TRUNCATE-TO-N-POSinONS 

>saf>inteiface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.Usp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

TRUNCATE-TO-N-POSmONS 

>saf>interface>model-menu.lisp 

None 


GIMME-VAR-NAME-OF-CURRENT-GRAPH 


>saf>interface>model-menu.lisp 

Macro 

0 

MKATOM 

>saf>sys>new-storage,lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-inenu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model'menu.lisp 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 
No  Source  File  Record 
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(METHOD  ALTER-PROBABIUTY  POINT) 

>saf>interface>tnodel*inenu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.lisp 

(MEIHOD  DRAG-UP-DOWN  POINT) 

>sa&interface>model-inenu.lisp 

SELECT-AND-DRAG-UP-DOWN-POINT 

>saf!>inteiface>model-nienu.Iisp 

GO-BACK-TO-PREVIOUS-STEP 

>saf!>interface>inodel-menu.lisp 

UPDATE-BACKTRACKING-CAPABILITY 

>saf>interface>model-nienu.lisp 

SELECT-AND-DRAG-POINT 

>saf>mterface>iiKxlel-inenu.lisp 

GET-POINT 

>saf>interface>inodel-menu.lisp 

(METHOD  ERASE-POINT-AND-LINES  POINT) 

>saf>interface>tnodel-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>inodeI-menu.lisp 

RECORD-NEW-POINT 

>saf>interface>tnodel-inenu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>inodel-menu.lisp 

UPDATE-POINT-LIST 

>saf>interface>inodel-menu.lisp 

HND-SURROUNDING-POINTS 

>saf>interface>model-tnenu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>model-inenu.li$p 

(METHOD  EXPUNGE  POINT) 

>saf>interface>inodel-menu.lisp 

DRAW-X-TICKS 

>saf>interface>modeI-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>niodel-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 


Description: 

None 

2.1.1.37 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

Type: 

Subst 

Arguments: 

Outputs: 

0 

Calls: 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storagc.lisp 
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Called  by: 


Description: 


♦MODE* 

>saf>inteiface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteiface>inodel-menu.lisp 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

(METHOD  ALTER-PROBABIUTY  POINT) 

>saf>inteiface>model-menu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>inodel-inenu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

SELECT-AND-DRAG-UP-DOWN-POINT 

>saf>inteiface>model-inenu.lisp 

UPDATE-BACKTRACKING-CAPABILITY 

>saf>interface>inodel-inenu.lisp 

SELECr-AND-DRAG-POINT 

>saf>interface>tnodel-menu.lisp 

GET-POINT 

>saf>inteiface>inodel-inenu.lisp 

(METHOD  ERASE-POINT-AND-LINES  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>inteTface>inodel-inenu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

UPDATE-POINT-LIST 

>saf>interface>modeI-menu.lisp 

nND-SURROUNDING-POINTS 

>saf>interface>model-menu.lisp 

DELETE-POINT-DF-THERE 

>saf>interface>model-nienu.lisp 

(METHOD  EXPUNGE  POITO 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>nKxlel-nienu.lisp 

None 
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2.1.1.38 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


2.1.1.39 


Type: 

Arguments: 

Outputs: 

Calls: 


GIMME-VAR-NAME-OF-CURRENT-POINTS 


>saf>interface>model*menu.lisp 

Macro 

0 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>inteiface>model-menu.lisp 

GIMME-VAR-NAME-OF-CURRENT-POINTS 

>saf>inteiface>model-menu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

UPDATE-POINT-LIST 

>saf>inteiface>modeI-menu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>model-menu.lisp 

GET-CURRENT-LINE-POINTS 

>saf>interface>model-menu.lisp 

GIMMF  /Aj^.naME-OF-CURRENT-POINTS 

>saf>inte  nacomodel-menu.lisp 

None 


GET-CURRENT-LINE-POINTS 


>saf>interface>model-menu.lisp 

Subst 

0 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.Usp 
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Called  by: 


Description: 


♦MC«DE* 

>saf>interface>model-roenu.lisp 

GIMME-VAR-NAME-OF-CURRENT-POINTS 

>saf>interface>model*inenu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

UPDATE-POINT-UST 

>saf>interface>inodel-inenu.Usp 

DELETE-POINT-IF-THERE 

>saf>inteiface>modeI~menu.lisp 

None 


2.1.2  Graphing  code 

[; ; ;  GRAPHING  code  ] 

This  is  the  code  used  to  draw  the  probability  graphs.  It  consists  of  functions  to  draw  the  X 
and  Y  axes  (with  their  marks,  calibrations,  and  labels),  and  functions  to  draw  the  graph 
proper.  The  top  construct  for  the  former  is  the  macro  CLEAN-UP-AXES- AND- 
REDRAW. 


The  top-level  function  fw  graph  constmction  is  PRESENT-GRAPH.  It  first  draws  the 
points  of  the  graph  and  then  the  connecting  straight-line  segments. 


Points  are  instances  of  the  flavor  POINT,  and  the  principal  methods  are  :DRAW  and 
:DRAG 


2.1.2.1  *X-AXIS.LENGTH* 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.li  sp 
Parameter 
0 

None 

MAKE-GRAPH-GIVEN-POINTS 

>saf>interface>model-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-menu.lisp 

DRAW-X-SCALE-BAR 

>saf>interface>mode]-menu.lisp 

None 
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2.1.2.2 

♦Y-AXIS-LENGTH* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

CMs: 

None 

Called  by  : 

DRAW-Y-TICKS 

Description: 

>saf>interface>model-menu.Usp 

DRAW-Y-SCALE-BAR 

>saf>interface>modeI-menu.lisp 

None 

2.1.2.3 

♦X-ORIGIN-INCREMENT* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

CaUedby: 

MAKE-GRAPH-GIVEN-POINTS 

Description: 

>saf>interface>model-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>model-menu.Usp 

DRAW-X-TICKS 

>saf>interface>model-menu.lisp 

None 

2.1.2.4 

♦TOTAL-X-RANGE* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

CaUedby: 

None 

Description: 

None 
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2.1.2.5 

•TOTAL-Y-RANGE* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

None 

Description: 

None 

2.1.2.6 

♦DELTA-X* 

Type: 

>saf>interface>model-menu.lisp 

Parameter 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

(METHOD  ALTER-PROBABILITY  POIND 

>saf>interface>model-menu.lisp 
(METHOD  ALTER-RANGE  POINT) 
>saf>interface>model-menu.lisp 
(METHOD  DRAG-UP-DOWN  POINT) 
>saf>interface>model-menu.lisp 
MAKE-GRAPH-GIVEN-POINTS 
>saf>interface>model-nienu.lisp 
(METHOD  DRAG  POIND 
>saf>interface>model-menu.lisp 
ADD-NEW-POINT 
>saf>interface>model-menu.lisp 
RESCALE-POINT-LIST 
>saf>interface>model-menu.lisp 
CALCULATE-POINT-DATA-FROM-PIXEl^TO-REAL 
>saf>interface>model-menu.lisp 
CALCULATE-POINT-DATA 
>saf>interface>model-menu.lisp 
Description:  None 
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2.1.2.7 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 

2.1.2.8 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


♦DELTA-Y* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

(METHOD  ALTER-PROBABILITY  POINT) 

>saf>intcrface>model-menu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

MAKE-GRAPH-GIVEN-POINTS 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.lisp 

RESCALE-PODMT-LIST 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA-FROM-PIXEL-TaREAL 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA 

>saf>interface>model-menu.lisp 

None 

♦ABSOLUTE-ORIGIN* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

(METHOD  ALTER-PROBABILITY  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

MAKE-GRAPH-GIVEN-POINTS 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>modeI-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA-FROM-PIXEUTaREAL 

>saf>interface>modeI-menu.lisp 

CALCULATE-POINT-DATA 
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Description: 


2.1.2.9 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


2.1.2.10 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>inteiface>model-menu.lisp 

None 


♦ABSOLUTE-X-ORIGIN* 


>saf>interface>model-inenu.lisp 

Parameter 

0 

None 

DRAW-Y-TICKS 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-inenu.lisp 

DRAW-Y-SCALE-BAR 

>saf>interface>model-menu.lisp 

DRAW-X-SCALE-BAR 

>saf>interface>model-menu.lisp 

None 


♦ABSOLUTE-Y-ORIGIN* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

DRAW-Y-TICKS 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-menu.lisp 

DRAW-Y-SCALE-BAR 

>saf>interface>model-menu.lisp 

DRAW-X-SCALE-BAR 

>saf>interface>model-menu.lisp 

None 
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2.1.2.11  DRAW-X-SCALE.BAR 


>saf>inteiface>model-menu.lisp 
Type:  Function 

Arguments:  (WINDOW  &KEY  (START-X  *ABSOLUTE-X  ORIGIN*) 

(START-Y  *ABSOLUTE-Y-ORIGIN*) 

(END-X  (+  *ABSOLUTE-X-ORIGIN*  *X-AXIS-LENGTH*))  (END-Y  *ABSOLUTE- 
Y-ORIGIN*)) 


Outputs: 

Calls: 


Called  by: 
Description: 


*X-AXIS-LENGTH* 

>$af>inteiface>model-menu.lisp 

*ABSOLUTE-X-ORIGlN* 

>saf>inteiface>model-menu.lisp 

*ABSOLUTE-Y-ORIGlN* 

>saf>interface>modeI-tnenu.lisp 

DRAW-SCALE-BAR 

>saf>interface>model-menu.lisp 

None 


2.1.2.12  DRAW-Y-SCALE-BAR 


>saf>interface>model-inenu.lisp 
Type:  Function 

Arguments:  (WINDOW  &KEY  (START-X  *ABSOLiniE-X-ORIGIN*) 

(START-Y  *ABSOLLnnE-Y-ORIGIN*) 

(END-X  *ABSOLUTE-X-ORIGIN*)  (END-Y  (-  *ABSOLUTE-Y-ORIGIN*  *Y-AXIS- 
LENGTH*))) 

Outputs: 

CaUs:  *Y-AXIS-LENGTH* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-X-ORIGIN* 

>saf>interface>model-menu.lisp 
♦ABSOLUTE- Y-ORIGIN* 

>saf>interface>modeI-menu.lisp 
Called  by:  DRAW-SCALE-BAR 

>saf>interface>model-menu.lisp 
Description:  None 
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2.1.2.13  DRAW-SCALE-BAR 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


>saf>inteiface>model-menu.lisp 

Function 

(WINDOW) 

DRAW-X-SCALE-BAR 

>sa£>inteiface>model-menu.lisp 

DRAW-Y-SCALE-BAR 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>inteiface>model-menu.lisp 

CLEAN-UP-AXIS-AND-REDRAW 

>saf>interface>model-menu.lisp 

None 


2.1.2.14  DRAW-X-TICKS 


>saf>interface>model-menu.lisp 
Type:  Function 

Arguments:  (WINDOW  &KEY  (X-LENGTH  ♦X-AXIS-LENGTH*) 

(INCREMENT  *X-ORIGIN-INCREMENT*) 

(START-X  ‘ABSOLUTE-X-ORIGIN*) 

(MAX-RANGE 

(IF  (AND  (OR  ♦DIR-FIR-TABLES* 

♦IND-FIR-TABLES* 

♦HIT-TABLES*) 

(GET-CURRENT-GRAPH-POINTS)) 

(FLOAT  (SEND  (CAR  (LAST  (GET-CURRENT-GRAPH-POINTS)))  REAL-X)) 
(CASE  *TABLE-TYPE* 

(DIRECT-FIRE-DAMAGE  90) 

(INDIRECT-HRE-DAMAGE  50) 

(T  3500.0))))) 

Outputs: 

Calls:  MKATOM 

>saf>sys>new-storagc.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

♦IND-FIR-TABLES* 

>saf>interface>model-inenu.lisp 

♦DIR-FIR-TABLES* 

>saf>inteTface>model-menu.lisp 

♦HIT-TABLES* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 
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Called  by: 

Description: 

2.1.2.15 

Type: 

Arguments: 

Outputs: 

Calls: 

Called  by: 


>saf>inteiface>model-menu.lisp 

*X-AXIS-LENGTH* 

>saf>interface>model'menu.lisp 

♦X-ORIGIN-INCREMENT* 

>saf>interface>model'inenu.lisp 

♦ABSOLUTEX-ORIGIN* 

>saf!>interface>model'menu.lisp 

♦ABSOLUTE-Y-ORIGIN* 

>saf>interface>nKxiel*menu.lisp 

PRESENT-DATA 

>saf>inteiface>model'menu.lisp 

DRAW-TICKS 

>saf^inteiface>model-menu.lisp 

None 


DRAW-Y-TICKS 


>saf>interface>model'menu.lisp 

Function 

(WINDOW  &KEY  (Y-LENGTH  *Y-AXIS-LENGTH*) 
(START-Y  *ABSOLUTE-Y-ORIGIN*)  (GRANULARITY 
10)) 

*Y-AXIS-LENGTH* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-X-ORIGIN* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-Y-ORIGIN* 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

DRAW-TICKS 

>saf>inteiface>model-menu.lisp 

None 


Description: 
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2.1.2.16 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


2.1.2.17 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


DRAW-TICKS 


>saf>interface>modei-menu.lisp 

Macro 

(WINDOW) 

DRAW-X-TICKS 

>saf>interface>modei-menu.lisp 

DRAW-Y-TICKS 

>saf>interface>nKxlel-menu.lisp 

DRAW-TICKS 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>sa£>inteiface>model-menu.lisp 

CLEAN-UP-AXIS-AND-REDRAW 

>saf>interface>model-menu.lisp 

DRAW-TICKS 

>saf>interface>modei-menu.Usp 

None 


CLEAN-UP-AXIS-AND-REDRAW 


>saf>inteiface>model-menu.Usp 

Macro 

(WINDOW) 

DRAW-SCALE-BAR 

>saf>inteiface>model-menu.lisp 

DRAW-TICKS 

>saf>interface>n[K)del-menu.lisp 

CLEAN-UP-AXIS-AND-REDRAW 

>saf>interface>nKxlei-menu.lisp 

PRESENT-DATA 

>saf>inteiface>model-menu.lisp 

CLEAN-UP-AXIS-AND-REDRAW 

>saf>interface>model-menu.bsp 

None 
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2.1.2.18  PRESENT-GRAPH 


>saf>inteiface>model-menu.lisp 
Type:  Function 

Arguments:  (GRAPH  WINDOW) 

(Dutputs: 

Calls:  POINT 

>saf>inteiface>model-menu.lisp 

POINT 

>saf^inteiface>modeI-menu.lisp 

*TABLE-TYPE* 

>saf>inteiface>model-menu.lisp 

POINT 

>saf>inteiface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 
UP-DOWN-POINT 
>saf>interface>model-menu.lisp 
CaUed  by:  PRESENT-DATA 

>saf>inteiface>model-menu.lisp 
Description:  None 


2.1.2.19  CALCULATE-POINT-DATA 


>saf>intetface>roodel-inenu.lisp 
Type:  Subst 

Arguments:  (X  Y) 

Outputs: 

Gills:  *DELTA-X* 

>saf>inteiface>model-menu.lisp 

♦DELTA-Y* 

>saf>inteiface>model-menu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.lisp 

Called  by;  (METHOD  ALTER-PROBABILITY  POINT) 

>saf>interface>tnodel-menu.lisp 
(METHOD  ALTER-RANGE  POIND 
>saf>interface>model-menu.lisp 
MAKE-GRAPH-GIVEN-POINTS 
>saf>interface>model-menu.lisp 
RESCALE-POINT-LIST 
>saf>interface>model-menu.lisp 
None 


Description: 
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2.1.2.20 


Type: 

Arguments: 
Outputs: 
Calls:  * 


Called  by: 


Description: 


2.1.2.21 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


2.1.2.22 


Type: 

Arguments: 

Outputs: 

Calls: 

CaUedby: 

Description: 


CALCULATE-POINT-DATA-FROM-PIXEL-TO-REAL 


>sa£>interface>model-menu.lisp 

Subst 

(PIXEL-X  PDCEL-Y) 

*DELTA-X* 

>saf>interface>model-inenu.lisp 

♦DELTA-Y* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model'menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>nKxlel-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>modeI-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.!isp 

None 


POINT 


>saf>interface>model-menu.lisp 

Ravor 

0 

None 

None 

None 


(METHOD  DRAW  POINT) 


>saf>interface>model-menu.lisp 

Method 

(WINDOW  &OPTIONAL  NEW-X  NEW- Y) 

None 

None 

None 


37 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


2.1.2.23 

(METHOD  DRAW-WITH-CHECK  POINT) 

Type: 

>saf>interface>model-menu.lisp 

Method 

Arguments: 

(WINDOW) 

Outputs: 

Calls: 

None 

Called  by  : 

None 

Description: 

None 

2.1.2.24 

(METHOD  ON-POINT?  POINT) 

Type: 

>saf>interface>model-inenu.lisp 

Method 

Arguments: 

(XY) 

Outputs: 

Calls: 

None 

Called  by: 

None 

Description: 

None 

2.1.2.25 

(METHOD  ERASE  POINT) 

Type: 

>saf>interface>model-menu.lisp 

Method 

Arguments: 

(WINDOW  &OPTIONAL  NEW-X  NEW- 

Outputs: 

Calls: 

None 

CaUedby: 

None 

Description: 

None 

2.1.2.26 

(METHOD  EXPUNGE  POINT) 

Type: 

>saf>interface>model-menu.lisp 

Method 

Arguments: 

0 

Outputs: 

Calls: 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storagc.lisp 

♦MODE* 

>saf>inteiface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-inenu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interfacc>model-menu.lisp 
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Called  by:  None 

Description:  None 


2.1.3  Graphics  manipulation  functions 

[; ; ;  Code  for  DELETing,  MOVing  and  INSERTing  points  in  graphs] 

Graph  points  can  be  deleted,  inserted,  and  moved. 

Inserting  a  new  point  entails  finding  first  the  pair  in-between  which  the  new  point  will  be. 
The  top-level  point  insertion  functions  are  RECORD-NEW-POINT  and  ADD-NEW- 
POINT. 

Moving  a  point  relies  on  the  ‘DRAG  method.  The  top-level  function  is  SELECT- AND- 
DRAG-POINT. 

2.1.3.1  DELETE-POINT-IF-THERE 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


>saf>inteiface>model-menu.lisp 

Function 

(XYWDMDOW) 

POINT 

>saf>inteTface>tnodel-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

♦TABULAR-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interfacc>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-POINTS 

>saf>interface>model-menu.lisp 

GET-CURRENT-LINE-POINTS 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

PRESENT-TABLE 

>saf>interface>modeI-menu.lisp 

(PRESENTATION-MOUSE-HANDLER  DELETE-POINT) 

No  Source  File  Record 

None 
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2.1.3.2 

LAST-CAR 

Type; 

>saf>interface>model-menu.lisp 

Macro 

Arguments; 

(LIST) 

Outputs; 

CaUs; 

LAST-CAR 

Called  by; 

>saf!>inteiface>model-menu.lisp 

FIND-SURROUNDING-POINTS 

Description; 

>saf>inteiface>model-inenu.lisp 

LAST-CAR 

>sa£>interface>modeI-menu.lisp 

None 

2.1.3.3 

MAKE-GAP-BETWEEN-POINTS 

Type; 

>saf>interface>model-n«nu.lisp 

Subst 

Arguments; 

(PI  P2  WINDOW) 

Outputs; 

Calls: 

DRAW-LINE-BETWEEN-POINTS 

Called  by; 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

Description; 

>saf>interface>model-menu.lisp 

None 

2.1.3.4 

DRAW-LINE-BETWEEN-POINTS 

Type; 

>saf>interface>model-menu.lisp 

Function 

Arguments; 

(PI  P2  WINDOW) 

Outputs; 

Calls; 

None 
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Called  by: 

Description: 

2.1.3.5 

Type: 

Arguments: 

Outputs: 

Calls: 

CaUedby: 

Description: 


(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  ERASE-PODSrr-AND-UNES  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.lisp 

MAKE-GAP-BETWEEN-POINTS 

>saf>inteiface>model-menu.lisp 

None 


GET-POINT-RIGHT 


>saf>interface>model-menu.lisp 

Subst 

(POINT  GRAPH) 

POINT 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  ERASE-POINT-AND-LINES  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>inteiface>model-menu.lisp 

HND-SURROUNDING-POINTS 

>saf>interface>model-menu.lisp 

GET-POINT-LEFT 

>saf>interface>model-menu.lisp 

None 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


2.1.3.6 


Type: 

Arguments: 

Ou^uts: 

Calls: 


Called  by: 


Description: 


2.1.3.7 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


GET-POINT-LEFT 


>saf>inteiface>model-menu.lisp 

Subst 

(POINT  GRAPH) 

POINT 

>saf>interface>model-menu.lisp 

GET-POINT-RIGHT 

>saf>interface>model-menu.lisp 

POINT 

>saf>inteiface>model-menu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model'menu.lisp 

(METHOD  ERASE-POINT-AND-UNES  POINT) 

>saf>interface>modeI-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 

FIND-SURROUNDING-POINTS 

>saf>inteTface>model-menu.lisp 

None 


FIND-SURROUNDING.POINTS 


>saf>interface>model-menu.lisp 

Function 

(XY) 

POINT 

>saf>interface>model-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

*MODE* 

>saf>interface>modeI-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>modeI-menu.lisp 

LAST-CAR 

>saf>interface>model-menu.lisp 

GET-POINT-RIGHT 

>saf>inteTface>model-menu.lisp 

GET-POINT-LEFT 

>saf>interface>model-menu.lisp 

POINT 

>saf>inteTface>model-menu.bsp 

ADD-NEW-POINT 

>saf>interface>modcl-menu.lisp 

None 
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2.1.3.8  SPLICE-IN-LIST-AFTER 


Type: 

Arguments: 
CXitputs: 
CaUs: 
Called  by: 

Description: 


>saf>interface>model-menu.lisp 

Function 

(ELEMENT  ELEMENT-AFTER  UST) 
None 

RECORD-NEW-POINT 

>saf>interface>model-menu.lisp 

None 


2.1.3.9  SPLICE-IN-LIST-AT-POSITION 


Type: 

Arguments: 
Outputs; 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Function 

(ELEMENT  POSITION  LIST) 

None 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

UPDATE-POnsrr-LIST 

>saf>interface>model-menu.lisp 

None 


2.1.3.10  UPDATE-POINT-LIST 


Type; 

Arguments: 

Outputs; 

Calls: 


Called  by; 


>saf>interface>model-menu.lisp 

Function 

(OLD-R  OLD-PROW) 

MKATOM 

>saf>sy  s>ne  w-  storage,  lisp 
CONCAT 

>saf>sys>new-storage.lisp 

*MODE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>modcl-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interfacc>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-POINTS 

>saf>interface>modeI-menu.lisp 

GET-CURRENT-LINE-POINTS 

>saf>interface>model-menu.lisp 

SPLICE-IN-LIST-AT-POSmON 

>saf>interfacc>model-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>modeI-menu.lisp 

(METHOD  ALTER-PROBABILITY  POINT) 
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Description: 

>saf>interface>modeI-menu.lisp 
(METHOD  ALTER-RANGE  POINT) 
>saf>interface>model-menu.lisp 
(METHOD  DRAG-UP-DOWN  POINT) 
>saf>interface>model-menu.lisp 
(METHOD  DRAG  POINT) 
>saf>interface>model-inenu.lisp 

None 

• 

2.1.3.11 

RESCALE-POINT-LIST 

Type: 

>saf>interface>model-menu.lisp 

Function 

Arguments: 

(POINT-UST) 

0^.puts: 

Calls: 

POINT 

>saf>interface>model-menu.lisp 

*TABLE-TYPE* 

>saf>interface>modei-menu.lisp 

*X-AXIS-LENGTH* 

>saf>interface>model-menu.lisp 

♦X-ORIGIN-INCREMENT* 

Called  by: 

>saf>interface>model-menu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

UPDATE-POINT-LIST 

• 

Description: 

>saf>interface>model-menu.lisp 

None 
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2.1.3.12 


Type: 

Arguments: 

Outputs; 

CaUs: 


Called  by: 
Description: 


2.1.3.13 


Type: 

Arguments: 

Outputs: 

Calls: 


ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 


>saf>interface>model-menu.lisp 

Function 

(X  Y  NEW-GRAPHICAL-INSTANCE) 
MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storagc.lisp 

♦MODE* 

>saf>inteiface>model-menu.lisp 

♦TABULAR-DISPLAY-PANE* 

>saf>interface>modeI-menu.lisp 

TRUNCATE-TO-N-POSmONS 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteTface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

GIMME-VAR-NAME-OF-CURRENT-POINTS 

>saf>interface>model-menu.lisp 

GET-CURRENT-LINE-POINTS 

>saf>interface>model-menu.lisp 

SPLICE-IN-LIST-AT-POSmON 

>saf>interface>model-menu.lisp 

PRESENT-TABLE 

>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.lisp 

None 


RECORD-NEW-POINT 


>saf>interface>model-menu.lisp 

Function 

(POINT  POINT- AFTER  LIST) 

POINT 

>saf>interface>model-nienu.lisp 

MKATOM 

>saf>sys>new-storagc.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

SPLICE-IN-LIST-AFTER 

>saf>intcrface>model-menu.lisp 

POINT 
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Called  by: 
Description; 


2.1.3.14 


Type: 

Arguments: 

Ou^uts: 

Calls: 


>saf>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>inteiface>model-inenu.lisp 

None 


ADD-NEW-POINT 


>saf>interface>model-menu.lisp 

Function 

(X  Y  WINDOW  &KEY  (UPDATE-TABLE  T)) 

POINT 

>saf^inteiface>model-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>intcrface>model-menu.lisp 

TRUNCATE-TO-N-POSmONS 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>modeI-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>inteiface>model-menu.lisp 

CALCULATE-POINT-DATA-FROM-PDCEl^TaREAL 

>saf>intcrface>model-menu.lisp 

MAKE-GAP-BETWEEN-POINTS 

>saf>interface>model-menu.lisp 

DRAW-LINE-BETWEEN-POINTS 

>saf>interface>model-menu.lisp 

nND-SURROUNDING-POINTS 

>saf>interface>model-menu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 
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Called  by: 


Description: 


RECORD-NEW-POINT 

>saf>interface>model-menu.lisp 

POINT 

>saf>inteiface>model-tiienu.lisp 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1) 
No  Source  FUe  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

None 


2.1.3.15  (METHOD  DRAG  POINT) 


Type: 

Arguments: 

Ou^uts: 

Calls: 


>saf>interface>model-menu.lisp 

'Method 

(WINDOW) 

POINT 

>saf>interface>model-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteiface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>model-menu  .lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA-FROM-PDCEI^TaREAL 

>saf>interface>model-menu.lisp 

DRAW-LINE-BETWEEN-POINTS 

>saf>interface>model-menu.lisp 

GET-POINT-RIGHT 

>saf>interface>model-menu.lisp 

GET-POINT-LEFT 

>saf>interface>model-roenu.lisp 

UPDATE-POINT-LIST 

>saf>inteiface>model-menu.lisp 
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POINT 

>saf>interface>model-menu.lisp 
PRESENT-DATA 
>saf>interface>model-menu.lisp 
Called  by:  None 

Description:  None 


2.1.3.16  (METHOD  ERASE-POINT-AND-LINES  POINT) 


>saf>interface>model-menu.lisp 
Type:  Method 

Arguments;  (WINDOW  &OPTIONAL  (DRAW-NEW-LINE?  NIL)) 

Outputs: 

Calls:  POINT 

>saf>inteiface>model-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

*MODE* 

>saf!>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>intetface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>inteiface>model-menu.lisp 

DRAW-LINE-BETWEEN-POINTS 

>saf>interface>model-menu.lisp 

GET-POINT-RIGHT 

>saf>interface>model-menu.lisp 

GET-POINT-LEFT 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 
(Dalled  by;  None 

Description;  None 
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2.1.3.17 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


2.1.3.18 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


GET-POINT 


>saf>interface>model-menu.lisp 

Subst 

(XY) 

MKATOM 

>saf>sys>new>storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>mode]-menu.lisp 

GIMME- VAR-NAME-OT-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>modeI-menu.lisp 

SELECT-AND-DRAG-UP-DOWN-POINT 

>saf>interface>model-menu.lisp 

SELECr-AND-DRAG-POINT 

>saf>interface>model-n9enu.lisp 

None 


SELECT-AND-DRAG-POINT 


>saf>interface>model-roenu.lisp 

Function 

(XYWINDOW) 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

GET-POINT 

>saf>interface>model-menu.lisp 
(PRESENTATION-MOUSE-HANDLER  MOVE-POINT) 
No  Source  File  Record 
None 
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2.1.3.19 


Type: 

Arguments: 

Outputs: 

Calls: 

CaUedby: 


Description: 


2.1.3.20 


Type: 

Arguments: 

Outputs: 

CaUs: 

Called  by: 


Description: 


2.1.3.21 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


LIST-INSTANCE-VARIABLES 


>saf>interface>model-menu.lisp 

Macro 

(INSTANCE) 

UST-INSTANCE-VARIABLES 

>saf>interface>model-menu.lisp 

MAKE-COPY-OF-INSTANCE-POINT 

>saf^inteiface>model-menu.lisp 

LIST-INSTANCE-VARIABLE-VALUES 

>saf>interface>model-menu.lisp 

CREATE-MAKE-INSTANCE-FORM-ARGS 

>saf>interface>model-inenu.lisp 

UST-INSTANCE-VARIABLES 

>saf>inteiface>model-menu.lisp 

None 


LIST-INSTANCE-VARIABLE- VALUES 


>saf>interface>model-menu.lisp 

Function 

(INSTANCE) 

LIST-INSTANCE-VARIABLES 

>saf>interface>model-menu.lisp 

MAKE-COPY-OF-INSTANCE-POINT 

>saf>interface>modeI-menu.lisp 

CREATE-MAKE-INSTANCE-FORM-ARGS 

>saf>interface>model-menu.lisp 

see  get-instance-variables 


CREATE-MAKE-INSTANCE-FORM-ARGS 


>saf>interface>model-menu.lisp 

Macro 

(INSTANCE) 

LIST-INSTANCE-VARIABLES 

>saf>interface>nKxlel-menu.lisp 

LIST-INSTANCE-VARIABLE-VALUES 

>saf>interface>model-menu.lisp 

CREATE-MAKE-INSTANCE-FORM-ARGS 

>saf>interface>nxxlel-menu.lisp 

MAKE-COPY-OF-INSTANCE-POINT 

>saf>interface>modeI-menu.lisp 

CREATE-MAKE-INSTANCE-FORM-ARGS 

>saf>intcrfacc>model-menu.lisp 

None 
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2.1.3.22 


Type: 

Arguments: 

CXi^uts: 

Calls: 


Called  by: 
Description: 


2.1.3.23 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


MAKE-COPY-OF-INSTANCE-POINT 


>saf>inteiface>model-menu.lisp 

Function 

(PT  &OPTIONAL  (FLAVOR-NAME  POIND) 
POINT 

>saf>inteiface>model-menu.lisp 

UST-INSTANCE-VARIABLES 

>saf>interface>model-menu.lisp 

UST-INSTANCE-VARIABLE-VALUES 

>safi>inteiface>model-nienu.lisp 

CREATE-MAKE-INSTANCE-FORM-ARGS 

>saf>inteiface>model-menu.lisp 

POINT 

>saf>inteiface>modeI-menu.Iisp 

COPY-POINT-LIST 

>saf>interface>tnodeI-nienu.lisp 

None 


♦GRAPH-BEFORE-LAST-STEP* 


>saf>inteTface>modeI-menu.lisp 

Parameter 

0 

None 

SET-CURRENT-MODEL 

>saf>inteiface>niodel-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-nienu.lisp 

GO-BACK-TaPREVIOUS-STEP 

>saf>interface>modeI-menu.lisp 

UPDATE-BACKTRACKING-CAPABILITY 

>saf>interface>tnodel-menu.lisp 

None 
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2.1.3.24 


Type: 

Arguments: 

Outputs: 

CaUs: 


CaUedby: 


UPDATE-BACKTRACKING-CAPABILITY 


>saf^interface>model-menu.lisp 

Function 

(AOPnONAL  (PTS  (GET-CURRENT-GRAPH-POINTS))) 
MKATOM 

>saf>sys>new-storage.lisp 

CXDNCAT 

>saf>sys>new-storage.lisp 

*MCX)E* 

>saf>inteiface>model-menu.lisp 

GIMME- VAR-NAME-(ff-CURRENT-GRAPH 

>saf!>interface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>safb>inte]face>model-menu.lisp 

*GRAPH-BEFORE-LAST-STEP* 

>saf!>inteiface>model-menu.lisp 

COPY-POINT-LIST 

>saf>interface>model'menu.lisp 

(PRESENTATION-xMOUSE-HANDLER  INSERT-POINT- 1) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  REPLACE- 

PROBABE^mO 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  REPLACE-RANGE) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  MOVE-UP-DOWN- 
POINT) 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  DELETE-POINT) 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  MOVE-POINT) 

No  Source  File  Record 
None 


Description: 
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2.1.3.25  COPY-POINT-LIST 


Type: 

Arguments: 

Ou^uts: 

Calls: 

Called  by: 

Description: 


>sa£>inteiface>model-menu.lisp 

Function 

(LIST) 

MAKE-COPY-OF-INSTANCE-POINT 

>saf>intetface>model'menu.lisp 

UPDATE-BACKTRACKING-CAPABILITY 

>saf>inteiface>model-menu.lisp 

None 


2.1.3.26  GO-BACK-TO-PREVIOUS-STEP 


Type: 

Arguments: 

Outputs: 

emails: 


Clalledby: 

Description: 


>saf>interface>model-menu.lisp 

Function 

(WINDOW) 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>ncw-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

GIMME-VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>model-menu.lisp 

♦GRAPH-BEFORE-LAST-STEP* 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

None 
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2.1.3.27 


Type: 

Arguments: 

CXitputs: 

CaUs: 


Called  by: 
Description: 


2.1.3.28 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 

Description: 


REVERT-TO-FACTORY-VERSION 


>saf>interface>modei'menu.lisp 

Function 

0 

*HOST-FOR-CONHG-DATA* 

>saf!>sys>inteiim-model.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦INDIRECT-FIRE-DAMAGE-FILE-NAME* 

>saf>intetface>model-menu.lisp 

♦DIRECT-FIRE-DAMAGE-FILE-NAME* 

>sa£>interface>modeI'menu.lisp 

EXTRACT-ITLE-NAME 

>saf!>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model-menu.Iisp 

READ-GROUND-DETECTION-DATA 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>modei-menu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>modeI-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

None 


EXTRACT-FILE-NAME 


>saf>interface>model-menu.lisp 

Function 

(UNK-FILE-SPEC) 

None 

REVERT-TO-FACTORY-VERSION 

>saf>interface>model-menu.lisp 

None 
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2.1.3.29 


Type; 

Arguments; 

Ou^uts; 

Calls; 


Called  by  ; 


GRAPH-UNDO 


>saf>inteiface>model-menu.lisp 

Function 

(WINDOW) 

*TABLE-TYPE* 

>saf>inteiface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>inteiface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>inteiface>model-menu.lisp 

♦IND-FIR-TABLES* 

>saf>inteiface>model-menu.lisp 

♦DIR-FIR-TABLES* 

>saf>interface>modeI-menu.lisp 

♦HIT-TABLES* 

>saf>inteiface>model-menu.lisp 

♦GRAPH-BEFORE-LAST-STEP* 

>saf>interface>model-menu.lisp 

GO-BACK-TO-PREVIOUS-STEP 

>saf>interface>model-menu.lisp 

REVERT-TO-FACTORY-VERSION 

>saf>interface>model-menu.lisp 

GET-TABLE 

>saf>interface>model'menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

(METHOD  COM-UNDO-IND-INTERNAL  MODEDMENU) 
No  Source  File  Record 

(METHOD  COM-UNDO-DIR-INTERNAL  MODEl^MENU) 
No  Source  File  Record 

(METHOD  COM-UNDO-INTERNAL  MODEL-MENU) 

No  Source  File  Record 
None 


Description; 
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2.1.4  Frame  and  screen  conflgurations. 

[; ; ;  FRAME  code  ] 

This  CSU  contains  the  code  that  define  the  Models  Editor  Frame  and  its  configurations,  as 
well  as  the  individual  panes  that  ^pear  within  it,  as  seen  on  the  screen. 

The  frame  itself  is  defined  as  a  program  framewcnk  with  duee  configurations:  MAIN- 
WITH-LOGO,  which  is  used  for  Hit  and  Detection  data;  MAIN-WTIH-LOGO-DIRECr- 
DAMAGE,  used  for  DIRECT  DAMAGE  data,  and  MAIN-WITH-L(XX)-INDIRECT- 
DAMAGE.  They  differ  mainly  in  the  commands  available  in  the  tt^  menu  bar.  The 
program  framework  is  called  MODn>-MENU,  fw  historical  reasrms.  See  the  Symbolics 
manuals  frx'  details  on  program  framewoks  and  how  they  are  defined  by  DEFINE- 
PROGRAM-FRAMEWORK 

The  TOP-LEVEL  method  of  MODEL-MENU  sets  up  a  bunch  of  global  variables, 
provides  mouse  documentation  data,  and  starts  up  the  frame.  It  also  creates 
♦HTTMODELS-DICnONARY*,  using  the  function  MAKE-HTTMODELS- 
DICnONARY,  from  the  File  input/output  CSU,  section  2.1.7. 

2.1.4. 1  MODEL-MENU 


>saf>interface>model'menu.lisp 
Type:  DEFINE-PROGRAM-FRAMEWORK 

Arguments:  () 

Outputs: 

Calls:  None 

CaDedby:  DEFINE-MODEl^MENU-COMMAND 

>saf>patch>saf-6>saf-6-5.1isp 
SELECT-MODEI^MENU 
>saf>interface>model-menu.lisp 
LEFT-ON-FIREPOWER-AT-PAR-l-MODEL-MENU- 
MENU-COMMAND 
>saf>interface>model-menu.lisp 

LEFT-ON-MOBIUTY-AT-PAR-  1-MODEL-MENU-MENU- 
COMMAND 

>saf>inteiface>model-menu.lisp 

LEFT-ON-CATASTROPHIC-AT-PAR-l-MODEL-MENU- 

MENU-COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-MOVING-AT-PAR-MODEL-MENU-MENU- 

COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-STATIONARY-AT-PAR-MODEL-MENU- 

MENU-COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-HULL-AT-PAR-MODEL-MENU-MENU- 

COMMAND 

>saf>interface>tnodel-menu.lisp 

LEFT-ON-UNDO-AT-COM-IND-MODEL-MENU-MENU- 

COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-WRTIE  TABLE-AT-COM-IND-MODEL-MENU- 
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MENU-COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-READ  TABLE-AT-OOM-IND-MODEI^MENU- 

MENU-COMMAND 

>saf>interface>inodel-menu.lisp 

LEFT-ON-SELECT  MODEl^AT-COM-IND-MODEI^ 

MENU-MENU-COMMAND 

>saf>interface>nK)del-menu.lisp 

LEFT-ON-UNDO-AT-COM-DIR-MODEL-MENU-MENU- 

COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-WRITE  TABLE-AT-COM-DIR-MODEL-MENU- 

MENU-COMMAND 

>saf>inteiface>iiKxiel-menu.lisp 

LEFT-ON-READ  TABLE-AT-COM-DIR-MODEL-MENU- 

MENU-COMMAND 

>saft>interface>model-menu.lisp 

LEFT-ON-SELECT  ASPECT-AT-COM-DIR-MODEL- 

MENU-MENU-COMMAND 

>saf>interface>iTKxiel-menu.lisp 

LEFT-ON-SELECT  MODEL-AT-COM-DIR-MODEl^ 

MENU-MENU-COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-UNIX)-AT-COM-MODEL-MENU-MENU- 

COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-WRITE  TABLE-AT-COM-MODEI^MENU- 

MENU-COMMAND 

>saf>interface>model-tnenu.lisp 

LEFT-ON-READ  TABLE-AT-COM-MODEL-MENU- 

MENU-COMMAND 

>saf>interface>model-menu.lisp 

LEFT-ON-SELECT  MODEL-AT-COM-MODEI^MENU- 

MENU-COMMAND 

>saf>interface>model-menu.lisp 

None 


Description: 
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2.1.4.2  (METHOD  MAKE-INSTANCE  MODEL-MENU  AFTER) 


>saf>inteiface>modeI-menu.lisp 
Type:  Method 

Arguments:  (&REST  INTT-ARGS) 

Ou^uts: 

CaUs:  *MaDEL-FRAME* 

>saf>interface>model-menu.lisp 
Called  by:  None 

Description:  None 


2.1.4.3  *MODEL-IO* 


>saf>interface>modeI-menu.lisp 
Type:  Parameter 

Arguments:  () 

Outputs: 

Calls:  None 

Called  by:  (METHOD  TOP-LEVEL  MODEL-MENU) 

>saf>interface>model-menu.lisp 
Description:  None 


2.1.4.4  *HITMODELS-DICTIONARY* 


>saf>interface>model-menu.lisp 
Type:  Parameter 

Arguments:  () 

Outputs: 

Calls:  None 

Called  by:  WRITE-HTT-DATA-FILE 

>saf>inteiface>model-menu.hsp 
(METHOD  TOP-LEVEL  MODEL-MENU) 
>saf>interface>model-menu.hsp 
Description:  None 
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2.1.4.5 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 
Description: 

2.1.4.6 


Type: 

Arguments: 

Outputs: 

Calls: 

Called  by: 

Description: 


(METHOD  TOP-LEVEL  MODEL-MENU) 


>saf>interface>model-menu.lisp 

Method 

(&RESTARGS) 

MOUSE-FLIP-SCREEN 

>saf>ui>mouse-interface.lisp 

FIND-MOUSE 

>saf>ui>mouse-interface.lisp 

SAF 

>saf>ui>£rame.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

♦TABULAR-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

♦MODEL-FRAME* 

>saf>interface>model-menu.lisp 

♦DISPLAY-LOGO-PANE* 

>saf>interface>model-menu.lisp 

♦TABULAR-LOGO-PANE* 

>saf>interface>model-menu.lisp 

♦MODEHO* 

>saf>interface>model-menu.lisp 

♦HTTMODELS-DICnONARY* 

>saf>interface>model-menu.lisp 

MAKE-DOCUMENTATON 

>saf>interface>model-menu.lisp 

MAKE-HITMODELS-DICnONARY 

>saf>interface>model-menu.lisp 

None 

None 

MAKE-DOCUMENTATION 


>saf>interface>modeI-menu.lisp 

Function 

(COMMAND-STRING  DOCUMENTATION-STRING 
AOPnONAL  (FRAME  *MODEL-FRAME*)) 

♦MODEHTIAME* 

>saf>interface>model-menu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 
>saf>interface>modeI-menu.lisp 
None 
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2.1.5  Command  processor  commands 
[; ; ;  CcHumand  Processor  User  Commands  ] 

The  user  commands  in  the  top  menu  bar  of  all  the  Models  Editors  are  provided  via  the 
system’s  Command  Processor  facility.  They  are  created  via  the  system's  constract 
DEFINE- [Program-Frame-Name]-COMMAND,  in  our  case  DEHNE-MODEL-MENU- 
COMMAND.  The  core  of  the  functionality  is  provided  by  die  function  call  within,  e.g.: 
(USER-SELECT-MODEL ...),  (SELECT-TABLE),  etc. 


2.1.5. 1  (COM-SELECT-MODEL  MENU-ACCELERATOR  Select  Model 

MENU-LEVEL  COM) 


Type: 

Arguments: 
Ouqiuts: 
C!alls: 
Called  by: 
Description: 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-CX)MMAND 

0 


None 

None 

None 


2.1.5.2  (COM-READ-TABLE  MENU-ACCELERATOR  Read  Table 
MENU-LEVEL  COM) 


Type: 

Arguments: 

Outputs: 

CaUs; 

Called  by: 
Description: 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 


2.1.5.3  (COM-WRITE-TABLE  MENU-ACCELERATOR  Write  Table 
MENU-LEVEL  COM) 


Type: 

Arguments: 
Outputs: 
Clalls: 
Called  by: 
Description: 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 
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2.1.5.4 


(COM-UNDO  MENU-ACCELERATOR  Undo  MENU-LEVEL 
COM) 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 


2.1.5.5  (COM-SELECT-MODEL-DIR  MENU-ACCELERATOR  Select 
Model  MENU-LEVEL  COM-DIR) 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 


None 

None 

None 


2.1.5. 


6 


(COM-SELECT-ASPECT-DIR  MENU-ACCELERATOR  Select 
Aspect  MENU-LEVEL  COM-DIR) 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


>saf>intcrface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 


None 

None 

None 


2.1.5.7  (COM-READ-TABLE-DIR  MENU-ACCELERATOR  Read  Table 
MENU-LEVEL  COM-DIR) 


>saf>interface>model-menu.lisp 

DEFINE-MODEI^MENU-COMMAND 

0 

None 

None 

None 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 
Description: 
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2.1.5.8 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 
Description: 


2.1.5.9 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 
Description: 

2.1.5.10 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 

2.1.5.11 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


(COM-WRITE-TABLE-DIR  MENU-ACCELERATOR  Write  Table 
MENU-LEVEL  COM-DIR) 


>sa£>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


(COM-UNDO-DIR  MENU-ACCELERATOR  Undo  MENU- 
LEVEL  COM-DIR) 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 


None 

None 

None 


(COM-SELECT-MODEL-IND  MENU-ACCELERATOR  Select 
Model  MENU-LEVEL  COM-IND) 


>saf>intetface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 

(COM-READ-TABLE-IND  MENU-ACCELERATOR  Read  Table 
MENU-LEVEL  COM-IND) 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 


None 

None 

None 
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2.1.5.12 


Type; 

Arguments: 

Outputs: 

CaUs: 

Called  by; 
Description: 


2.1.5.13 


Type: 

Arguments; 
Outputs: 
CaUs: 
Called  by: 
Description: 


2.1.5.14 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


2.1.5.15 


Type: 

Arguments: 
Outputs; 
Calls; 
Called  by: 
Description; 


(COM-WRITE-TABLE-IND  MENU-ACCELERATOR  Write 
Table  MENU-LEVEL  COM-IND) 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


(COM-UNDO-IND  MENU-ACCELERATOR  Undo  MENU- 
LEVEL  COM-IND) 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


(COM-HULL  MENU-ACCELERATOR  Hull  MENU-LEVEL 
PAR) 


>saf>interface>model'menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 


None 

None 

None 


(COM-STATIONARY  MENU- ACCELERATOR  Stationary 
MENU-LEVEL  PAR) 


>saf>interface>model-menu.lisp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 
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2.1.5.16 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 
Description: 


2.1.5.17 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 
Description: 


2.1.5.18 


Type: 

Arguments: 

Outputs: 

CaUs: 

CaUedby: 

Description: 


(COM-MOVING  MENU-ACCELERATOR  Moving  MENU- 
LEVEL  PAR) 


>safb>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


(COM-CATASTROPHIC  MENU-ACCELERATOR  Catastrophic 
MENU-LEVEL  PAR-1) 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


(COM-MOBILITY  MENU-ACCELERATOR  Mobility  MENU- 
LEVEL  PAR-1) 


>saf>interface>raodel-menu.Usp 

DEFINE-MODEL-MENU-COMMAND 

0 

None 

None 

None 
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2.1.5.19 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


2.1.5.20 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


(COM-FIREPOWER  MENU-ACCELERATOR  Firepower  MENU- 
LEVEL  PAR-1) 


>saf>interface>model-menu.lisp 

DEFINE-MODEl^MENU-COMMAND 

0 

None 

None 

None 


MAKE-GRAPH-GIVEN-POINTS 


>saf>interface>model-menu.lisp 

Function 

(LINE) 

POINT 

>saf>inteiface>model-menu.lisp 

LINE 

>saf>cm>line.lisp 

LINE 

>saf>cm>line.lisp 

LINE 

>saf>cm>line.lisp 

♦TABLE-TYPE* 

>saf>interface>model‘menu.lisp 

*X-AXIS-LENGTH* 

>saf>inteTface>model-menu.lisp 

*X-ORIGIN-INCREMENT* 

>saf>interface>model-menu.lisp 

*DELTA-X* 

>saf>interface>model-menu.lisp 

*DELTA-Y* 

>saf>interface>model-mcnu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

None 


Description: 
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2.1.5.21  SWITCH-HIGHLIGHT 


>saf>inteiface>model~menu.lisp 
Type:  Function 

Arguments:  () 

Ou^uts: 

Calls:  HIGHLIGHT-BUTTON-1 

>saf>ui>frame-utils.Iisp 
OONCAT 

>saf!>sys>new-storage.lisp 

♦OLD-SELECnON* 

>saf>inteiface>model-menu.lisp 

*M<X)E* 

>saf>interface>model-menu.lisp 
Called  by:  CHANGE-MODE 

>saf>interface>model-menu.lisp 
Description:  None 


2.1.5.22  CHANGE-MODE 


>saf>interface>model-menu.lisp 
Type:  Function 

Arguments:  (TYPE  WINDOW) 

Outputs: 

Calls:  ♦HULL-GRAPH* 

>saf>interface>model-menu.lisp 

♦STATIONARY-GRAPH* 

>saf>interface>model*menu.lisp 

♦MOVING-GRAPH* 

>saf>interface>model'menu.lisp 

♦CATASTROPHIC-GRAPH* 

>saf>interface>model'menu.lisp 

♦MOBILITY-GRAPH* 

>saf>interface>model-menu.lisp 

♦FIREPOWER-GRAPH* 

>saf>interface>model-menu.lisp 

♦HULL-POINTS* 

>saf>interface>modeI-menu.lisp 

♦STATIONARY-POINTS* 

>saf>interface>model-menu.lisp 

♦MOVING-POINTS* 

>saf>interface>model-menu.lisp 

♦CATASTROPHIC-POINTS* 

>saf>interface>modcl-menu.lisp 
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CaUedby: 


Description: 


2.1.5.23 


Type: 

Arguments: 

Outputs: 

CaUs: 


♦MOBILITY-POINTS* 

>saf>interface>model-menu.lisp 

♦HREPOWER-POINTS* 

>saf>interface>model-menu.Iisp 

*MCH)E* 

>saf!>interface>model-menu.lisp 

MAKE-GRAPH-GIVEN-POINTS 

>saf>inteiface>model-menu.lisp 

SWITCH-HIGHLIGHT 

>saf>inteiface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

(METHOD  COM-FIREPOWER-INTERNAL  MODEI^MENU) 

No  Source  File  Record 

(METHOD  COM-MOBILITY-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-CATASTROPHIC-INTERNAL  MODEL-MENU) 
No  Source  File  Record 

(METHOD  COM-MOVING-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

(METHOD  COM-STATIONARY-INTERNAL  MODEl^MENU) 

No  Source  File  Record 

(METHOD  COM-HULL-INTERNAL  MODEL-MENU) 

No  Source  File  Record 
None 


SELECT-HOST 


>saf>interface>model-menu.lisp 

Function 

0 

MENU-CHOOSE 

>saf>sys>utilities.lisp 

♦HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 

GET-HOSTS-Wrm-SIMNET-SERVICE 

>saf>network>vars.lisp 

CONCAT 

>saf>sys>new-storage.lisp 
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CaUedby: 


Description: 


2.1.5.24 


Type: 

Arguments: 

Ouqjuts: 

CaUs: 


CaUedby: 

MENU) 


MENU) 


Description: 


2.1.5.25 


Type: 

Arguments: 

Outputs: 

CaUs: 


CaUedby: 

Description; 


READ-CONHGURATION-FILE 

>saf>interface>foimations.Usp 

MAKE-HTTMODELS-DICnONARY 

>saf>interface>model-menu.Usp 

SELECT-TABLE 

>saf>inteiface>model-menu.Usp 

None 


SELECT-TABLE 


>saf>interface>model-menu.Usp 

Function 

0 

♦HOST-FOR-CONnO-DATA* 

>saf>sys>interim-model.lisp 

SELECT-HOST 

>saf>interface>model-menu.Usp 

DISPATCH-TO-TABLE 

>saf>interface>model-menu.Usp 

(METHOD  COM-READ-TABLE-IND-INTERNAL  MODEl^ 
No  Source  FUe  Record 

(METHOD  COM-READ-TABLE-DIR-INTERNAL  MODEl^ 

No  Source  FUe  Record 

(METHOD  COM-READ-TABLE-INTERNAL  MODEL-MENU) 

No  Source  FUe  Record 

None 


DISPATCH-TO-TABLE 


>saf>interface>model-menu.Usp 

Function 

0 

READ-HIT-DATA 

>saf>inteTface>model-menu.Usp 

READ-GROUND-DETECnON-DATA 

>saf>inteiface>model-menu.Usp 

REAI>AIR-DETECnON-DATA 

>saf>interface>modeI-menu.Usp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-menu.Usp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.Usp 

SELECT-TABLE 

>saf>interface>model-menu.Usp 

None 
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2.1.5.26 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
MENU) 


MENU) 


Description: 


USER-SELECT-MODEL 


>saf!>interface>model-menu.lisp 

Function 

(WINDOW  &OPnONAL  (TABLE-UST  *HIT-TABLES*)) 
NAME 

>saf>sysdcl.lisp 

♦TABLE-TYPE* 

>saf>inteiface>model-menu.lisp 

♦IND-FIR-TABLES* 

>saf>interface>modeI-menu.Iisp 

♦DIR-FIR-TABLES* 

>saf!>interface>model-menu.lisp 

♦HIT-TABLES* 

>saf>interface>modeI-menu.iisp 

GET-TABLE 

>saf>inteiface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

GET-NEW-WEAPON-NAME 

>saf>inteiface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>inteiface>model-menu.lisp 

(METHOD  COM-SELECT-MODEL-IND-INTERNAL  MODEL- 
No  Source  File  Record 

(METHOD  COM-SELECr-MODEL-DIR-lNIERNAL  MODEL- 
No  Source  File  Record 

(METHOD  CX)M-SELECr-MODEL-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

None 
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2.1.5.27  USER-SELECT-ASPECT 


Type: 

Arguments: 

C>uq)uts: 

CaUs: 


Called  by: 
MENU) 

Description: 


>saf>inteiface>model-menu.lisp 

Function 

(WINDOW) 

*PART* 

>saf>interface>model-menu.lisp 

♦ASPECT* 

>saf>inteiface>model-inenu.lisp 

♦WEAPON-NAME* 

>saf>inteiface>model-menu.lisp 

♦DIR-FIR-TABLES* 

>saf>interface>model-inenu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>nK)de)-menu.lisp 

(METHOD  COM-SELECT-ASPECT-DIR-INTERNAL  MODEL- 

No  Source  File  Record 
None 


2.1.6  Panes  and  their  presentations. 

[; ; ;  PANES,  their  flavor  deflnitions,  and  related  code  ] 

The  panes  within  the  MODEL-MENU  frame  are  either  system-provided  or  are  specifically 
defined.  This  unit  contains  the  code  to  define  two  special  panes,  as  well  as  the 
presentations  and  presentadon-actions  that  impart  the  rest  of  the  user  functionality.  The  two 
special  panes  are  PARAMETER-DISPLAY-PANE,  where  the  graph  is  displayed,  and  MS- 
PANE,  where  the  numeric  table  representation  is  displayed. 

The  code  is  organized  around  each  pane  definition:  a  pane  is  first  defined  as  a  flavor, 
followed  by  presentation  type  definitions  and  the  actions  associated  with  the  presentation. 

In  the  PARAMETER-DISPLAY-PANE,  the  presentation-tyi^  POINT  (there  is  also  a 
flavor  POINT,  a  different  kind  of  object)  has  associated  with  it  the  presentation-action 
MOVE-POINT,  which  calls  the  top-level  point-moving  function  SELECT-AND-DRAG- 
POINT  (see  above). 
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It  is  worth  noticing  that  while  Hit,  and  Detecdtxi  points  have  two  degrees  of  freedom  of 
nx)vement  (upndown  and  left-right).  Direct  Damage  points  are  given  in  terms  of  three  fixed 
angles  of  indicence  (30®,  60°,  a^  90°)  and  therefore  can  be  moved  only  up-down.  This  is 
refiected  in  special  presentatitm-types  and  actions  for  theta 

In  the  MS-PANE,  two  presentation  types  are  defined,  PROBABILITY  and  RANGE,  with 
their  associated  actions  REPLACE-PROBABILITY  and  REPLACE-RANGE.  This  last 
action  calls  the  funcdon  REPLACE-RANGE,  which  sends  the  message  :XREPLACE- 
OBJECT- VALUE  to  the  selected  pane  in  the  cditcM-.  This  message  is  a  rewrite  of  the 
symbolics  dynamic-window  meth^  :REPLACE-OBJECT-VALUE,  and  is  defined  a  few 
forms  below  where  it  is  used,  just  after  the  comment 

; ; ;  Altered  version, ... 

Nodce  that  the  defmethod  call  is  preceeded  by  "dw::",  indicadng  that  the  method  is  to  be 
created  in  the  dynamic-windows  package: 

dw:: 

(defmethod  (:xreplace-object-value  dynamic-window) ... ) 

This  unit  also  contains  the  cp:define-command  definidon  for  COM-MODELS,  the 
cotiunand  processor  command  to  start  the  models  editor.  This  command  calls  SELECT- 
MODEL-MENU,  the  top  level  funcdon  for  the  models  editor.  These  forms  appear  under 
the  following  comment: 

; ; ;  Define  command-processor  command  for  the  models  editor 


2.1.6.1 

DYNAMIC-WINDOW-WITHOUT-SCROLL-BARS 

Type: 

>saf>interface>model-menu.lisp 

Flavor 

Arguments: 

0 

Outputs: 

Calls: 

None 

(Tailed  by: 

None 

Descripdon: 

None 

2.1.6.2 

MS-DYNAMIC-WINDOW-PANE 

Type: 

>saf>interface>model-menu.lisp 

Flavor 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

None 

Descripdon: 

None 
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2.1.6.3 


PARAMETER-DISPLAY-PANE 


Type: 

Arguments: 

Outputs: 

CaUs: 

CaUedby: 

Description: 


>saf>interface>model-menu.lisp 

Havor 

0 

None 

None 

None 


2.1.6.4  POINT 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-TYPE 

0 


None 

(PRESENTATION-MOUSE-HANDLER  DELETE-POINT) 
No  Source  File  Record 


(PRESENTATION-MOUSE-HANDLER  MOVE-POINT) 

No  Source  File  Record 

PRESENT-TABLE 

>saf>interface>model-mcnu.lisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interfacc>model-menu.lisp 

(METHOD  ERASE-POINT-AND-LINES  POINT) 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 


>saf>interface>model-menu.lisp 

RECORD-NEW-POINT 

>saf>interface>model-menu.lisp 

RESCALE-POINT-LIST 

>saf>interface>model-menu.lisp 

FIND-SURROUNDING-POINTS 

>saf>interface>modeI-menu.lisp 

GET-POINT-LEFT 

>saf>interface>model-menu.lisp 

GET-POINT-RIGHT 

>saf>interface>model-menu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>model-mcnu.lisp 

PRESENT-GRAPH 

>saf>interface>model-menu.lisp 


72 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


SORT-CMS 

>saf>cin>overlay.lisp 

(METHOD  MOVE-CONTROL-MEASURE  ZONE) 

>saf>cin>zone.lisp 

(METHOD  COPY  ZONE) 

>saf>cm>zone.lisp 

(METHOD  MOVE-CONTROL-MEASURE  AREA) 

>saf>cm>area.lisp 

(METHOD  COPY  AREA) 

lien 

(METHOD  ORTHOGONALIZE  GENERIC-AREA) 
>saf>cin>generic-area.lisp 

(METHOD  INSERT-POINT-BEFORE  GENERIC-AREA) 

>saf>cm>generic-area.lisp  _ 

(METHOD  INSERT-POINT-AFTER  GENERIC-AREA) 

>saf>cm>generic-area.lisp 

(METHOD  DELETE-POINT  GENERIC-AREA) 

>saf>cm>generic-area.lisp 

(METHOD  MOVE-POINT  GENERIC-AREA) 

>saf>cm>generic-area.lisp 

(METHOD  PAINT-NAME  GENERIC-AREA) 

>saf>cm>generic-area.Iisp 

(METHOD  INTITALIZE-POINTS  GENERIC-AREA) 

>saf>cm>generic-area.lisp 

(METHOD  COPY  LINE) 

>saf>cm>line.lisp 

(METHOD  MOVE-CONTROL-MEASURE  LINE) 
>saf>cm>line.lisp 

(METHOD  INSERT-POINT-BEFORE  LINE) 

>saf>cm>line.lisp  _ 

(METHOD  INSERT-POINT-AFTER  LINE) 

>saf>cm>line.lisp 

(METHOD  DELETE-POINT  LINE) 

>saf>cm>line.lisp 
(METHOD  MOVE-POINT  LINE) 

>saf>cm>line.lisp 

(METHOD  ORTHOGONALIZE  LINE) 

>saf>cm>line.lisp 

(METHOD  INTTIALIZE-POINTS  LINE) 

>saf>cm>line.  lisp 

MAKE-POINT 

>saf>cm>point.lisp 

(PRESENTATION-MOUSE-HANDLER  CM-POINT- 
GESTURE) 

No  Source  File  Record 

(METHOD  DELETE-POINT  CM-POINT) 

>saf>cm>point.lisp 

(METHOD  MOVE-POINT  CM-POINT) 

>saf>cm>point.lisp 

(METHOD  COPY  ROUTE) 

>saf>cm>route.lisp 

(METHOD  INSERT-POINT-BEFORE  ROUTE) 
>saf>cm>route.lisp 

(METHOD  INSERT-POINT-AFTER  ROUTE) 
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>saf>cni>route.lisp 

(METHOD  DELETE-POINT  ROUTE) 

>saf>cm>route.lisp 

(METHOD  MOVE-POINT  ROUTE) 

>saf>cm>rDute.lisp 

(METHOD  ORTHOGONALIZE  ROUTE) 
>saf>cm>route.lisp 

(METHOD  INmAUZE-POINTS  ROUTE) 

>saf>cin>route.lisp 

SKIRT-LAKE 

>saf>cin>water-avoidance.lisp 

HNAL-RELAX-POINTS 

>saf>cm>water-avoidance.lisp 

RELAX-POINTS-AUX 

>saf>cin>water-avoidance.lisp 

PRUNE-TO-POINT 

>saf>cm>water-avoidance.lisp 

MOUSE-ON-BRIDGE-APPROACH-POINT 

>saf>cm>road-routes.lisp 

GET-ROAD-SEGMENT-POINT 

>saf>cm>road-routes.lisp 

GET-ROAD-POINT 

>saf>cm>road-routes.lisp 

(PRESENTATION-MOUSE-HANDLER  CONTROL- 
MEASURE-GESTURE) 

No  Source  File  Record 

(NCWHOPPER  INSERT-POINT-BEFORE  CONTROL- 
MEASURE) 

No  Source  File  Record 

(NCWHOPPER  INSERT-POINT-AFTER  CONTROL- 
MEASURE) 

No  Source  File  Record 

(NCWHOPPER  DELETE-POINT  CONTROL-MEASURE) 
No  Source  File  Record 

(NCWHOPPER  MOVE-POINT  CONTROL-MEASURE) 
No  Source  File  Record 

(METHOD  INTERVENE  SIMNET-AGENT  LAND) 

>saf>objects>intervention.lisp 

(METHOD  INTERVENE  SIMNET-AGENT  GO-Ta 

LOCATION) 

>saf>objects>intervention.lisp 

FACE-DIRECTION 

>saf>objects>simnet-agent.lisp 
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Description: 


2.1.6.5 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


2.1.6.6 


Type: 

Arguments: 

Outputs: 

Calls: 


SEND-POINT 

>saf>network>commands.lisp 

BOMB-BUTTON 

>saf>network>commands.lisp 

PRESENT-TABLE 

>saf>interface>model-menu.lisp 

MAKE-GRAPH-GIVEN-POINTS 

>saf>inteiface>model-menu.lisp 

MAKE-COPY-OF-INSTANCE-POINT 

>sa£>interface>model-menu.lisp 

ADD-NEW-POINT 

>saf>interface>model-menu.lisp 

PRESENT-GRAPH 

>saf>interface>model-menu.lisp 

(METHOD  SEND-OVERLAY-TO-SIMHOST  OVERLAY) 

>saf>cm>overlay.lisp 

CISS-FOR-CONTROL-MEASURE 

>saf>sys>interim-modeLlisp 

None 


MOVE-POINT 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-ACTION 

0 

None 

(PRESENTATION-MOUSE-HANDLER  CM-POINT- 
GESTURE) 

No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  CONTROL- 
MEASURE-GESTURE) 

No  Source  File  Record 
None 


DELETE-POINT 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-ACTION 

0 


None 
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Called  by: 


Description: 


2.1.6.7 


Type: 

Arguments: 
Ouq)uts: 
Calls: 
Called  by: 
Description: 


2.1.6.8 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 
Description: 


2.1.6.9 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


(PRESENTATION-MOUSE-HANDLER  CM-POINT-GESTURE) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  CONTROL- 
MEASURE-GESTURE) 

No  Source  File  Record 
None 


INSERT-POINT 


>saf>inteiface>model-menu.lisp 

DEFINE-PRESENTATION-ACnON 

0 

None 

None 

None 


INSERT-POINT.l 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-ACTION 

0 


None 

None 

None 


UP-DOWN-POINT 


>saf>interface>modeI-menu.lisp 

DEFINE-PRESENTATION-TYPE 

0 

None 

(PRESENTATION-MOUSE-HANDLER  MOVE-UP-DOWN- 
POINT) 

No  Source  File  Record 
PRESENT-GRAPH 
>saf>interface>modeI-menu.lisp 
None 
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2.1.6.10 


Type: 

Arguments: 

Ouqjuts: 

CaUs: 

Called  by: 
Description: 


2.1.6.11 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
POINT) 

Description: 


2.1.6.12 


Type: 

Arguments: 

Outputs: 

CaUs: 


MOVE-UP-DOWN-POINT 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-ACTION 

0 

None 

None 

None 


SELECT-AND-DRAG-UP-DOWN-POINT 


>saf>inteiface>model-menu.lisp 

Function 

(XYWINDOW) 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

*MC»E* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteiface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

GET-POINT 

>saf>interface>model-mcnu.lisp 

(PRESENTATION-MOUSE-HANDLER  MOVE-UP-DOWN- 

No  Source  File  Record 
None 


(METHOD  DRAG-UP-DOWN  POINT) 


>saf>interfacc>model-menu.lisp 

Method 

(WINDOW) 

POINT 

>saf>inteiface>model-menu.lisp 

MKATOM 

>saf>sys>new-storage.lisp 
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CONCAT 

>saf>sys>new-storagc.lisp 

♦MODE* 

>saf>inteiface>inodel-inenu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>inteiface>modeI-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteiface>modeI-inenu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>inteiface>inodel-inenu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>modeI-inenu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>tnodel-menu.lisp 

CALCULATE-POINT-DATA-FROM-PD(EL-TO-REAL 

>saf>interface>model-inenu.lisp 

DRAW-LINE-BETWEEN-POINTS 

>saf>interface>inodel-inenu.lisp 

GET-POINT-RIGHT 

>saf>interface>modeI-menu  .lisp 

GET-POINT-LEFT 

>saf>interface>model-menu.lisp 

UPDATE-POINT-LIST 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>modeJ-inenu.lisp 

PRESENT-DATA 


>saf>inteiface>model-nienu.lisp 


Called  by: 

None 

Description: 

None 

2.1.6.13 

MS-PANE 

Type: 

>saf>interface>model-menu.lisp 

Flavor 

Arguments: 

0 

Ouq>uts: 

Calls: 

None 

Called  by: 

None 

Description: 

None 
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2.1.6.14  RANGE 


Type: 

Arguments: 

Outputs: 

Calls: 

CaUedby: 


Description: 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-TYPE 

0 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACE-RANGE) 

No  Source  File  Record 

PRESENT-TABLE 

>saf>interface>model-menu.lisp 

(PROPERTY  RANGE  DEFTYPE) 

No  Source  File  Record 
None 


2.1.6.15  PROBABILITY 


Type: 

Arguments: 

Outputs: 

CaUs: 

Called  by: 
PROBABILITY) 


Description: 


>saf>interface>modeI-menu.lisp 

DEFINE-PRESENTATION-TYPE 

0 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACE- 

No  Source  File  Record 
PRESENT-TABLE 
>saf>interface>model-menu.lisp 
(PROPERTY  PROBABILITY  DEFTYPE) 

No  Source  File  Record 
None 


2.1.6.16  REPLACE-RANGE 


Type: 

Arguments: 

Outputs: 

Calls: 

CMedby: 

Description; 


>saf>interface>model-mcnu.lisp 

DEFINE-PRESENTATION-ACnON 

0 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACE-RANGE) 

No  Source  File  Record 

None 
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2.1.6.17 


Type; 

Arguments; 
Outputs; 
Calls; 
Called  by; 

Description; 


2.1.6.18 


Type; 

Arguments; 

Outputs; 

Calls; 


CaUedby; 

Description; 


REPLACE.RANGE 


>saf>inteiface>model'menu.lisp 

Function 

(OLD-RANGE  PRESENTATION  WINDOW) 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACE-RANGE) 

No  Source  File  Record 

None 


(METHOD  ALTER-RANGE  POINT) 


>saf>interface>model-menu.lisp 

Method 

(NEW-RANGE) 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model'menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.Iisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>inteiface>model-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>model-menu.lisp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.lisp 

CALCULATE-POINT-DATA 

>saf>interface>model-menu.lisp 

UPDATE-POINT-LIST 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>modeI-menu.lisp 

None 

None 
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2.1.6.19  REPLACE-PROBABILITY 


Type: 

Arguments: 
C>uq)uts: 
CaUs: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

DEFINE-PRESENTATION-ACTION 

0 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACE- 
PROBABIL^ 

No  Source  File  Record 
None 


2.1.6.20  REPLACE-PROBABILITY 


Type: 

Arguments: 

Outputs: 

CaUs: 

CaUedby: 

PROBABILITY) 

Description: 


>saf>inteTface>model-menu.lisp 

Function 

(PRESENTATION  WINDOW) 

None 

(PRESENTATION-MOUSE-HANDLER  REPLACX- 

No  Source  File  Record 
None 


2.1.6.21  (METHOD  ALTER-PROBABILITY  POINT) 


>saf>interface>model-menu.lisp 
Type:  Method 

Arguments:  (NEW-PROBABILITY) 

Outputs: 

CaUs:  MKATOM 

>saf>sys>new-storagc.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦MODE* 

>saf>interface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

GIMME- VAR-NAME-OF-CURRENT-GRAPH 

>saf>interface>mode)-menu.lisp 

GET-CURRENT-GRAPH-POINTS 

>saf>interface>model-menu.lisp 

♦DELTA-X* 

>saf>interface>model-menu.lisp 

♦DELTA-Y* 

>saf>interface>modeI-menu.Usp 

♦ABSOLUTE-ORIGIN* 

>saf>interface>model-menu.Usp 

CALCULATE-POINT-DATA 
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Called  by: 

>saf>interface>nKxiel-menu.lisp 

UPDATE-POINT-LIST 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

None 

• 

Description: 

None 

2.1.6.22 

(METHOD  XREPLACE-OBJECT- VALUE  DYNAMIC-WINDOW) 

Type: 

>saf>interface>model-menu.lisp 

Method 

Arguments: 

(DISPLAYED-PRESENTATION) 

Outputs: 

CaUs: 

None 

Called  by: 

None 

Description: 

None 

2.1.6.23 

COM-MODELS 

Type: 

>saf>interface>model-menu.lisp 

CP  Command 

Arguments: 

0 

• 

Outputs: 

Calls: 

SELECT-MODEL-MENU 

Called  by: 

>saf>interface>model-menu.lisp 

None 

Description: 

None 

2.1.6.24 

SELECT-MODEL-MENU 

Type: 

>saf>interface>model-menu.lisp 

Function 

Arguments: 

0 

Outputs: 

• 
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Calls: 


Called  by: 
Description: 


*PARAMETER-DISPLAY-PANE* 

>saf>inteiface>model-menu.lisp 

*PARAMETER-DISPLAY-PANE* 

>saf>inteTface>model-menu.lisp 

MODEL-MENU 

>saf>interface>modei-menu.lisp 

COM-MCOELS 

>saf>inteiface>model-menu.lisp 

None 


2.1.7  File  input/output  and  database  preparation 

[; ; ;  FILE  I/O  and  database  preparation  for  internal  use  ] 

Since  the  various  data  are  stored  in  different  files  in  different  formats  there  are  specialized 
READ-...  and  a  WRITE-  functions  for  each:  Hit,  Detection,  Indirect  Damage,  and  Direct 
Damage. 

The  file  data  is  organized  into  internal  tables  (e.g.:  HIT-TABLE,  IND-FIR-TABLE,  and 
DIR-FIR-TABLE),  and  specialized  functions  u>  gather  or  extract  chunks  of  data  are 
provided. 

Functions  such  as  EXTRACT-RANGE-AND-DICE-NUMBERS  are  necessary  because 
probability  distributions  are  represented  in  different  ways  on  the  Simhost 
and  in  the  model-menu  code. 


This  unit  also  includes  the  function  MAKE-HTTMODELS-DICTIONARY,  which  creates 
an  upper-case  to  mixed-case  translation  table  so  that  upper-case  Lisp  sjrobols  can  be 
restoi^  to  their  (Higinal  mixed-case  form  before  being  written  to  the  Simhost 


2.1.7.1  HIT-TABLE 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

DEFSTRUCT 

0 

None 

BUILD-A-HTT-TABLE 

>saf>interface>model-menu.lisp 

HTT-TABLE-P 

>saf>interface>model-menu.lisp 

COPY-HIT-TABLE 

>saf>inteTface>model-menu.Iisp 

MAKE-HIT-TABLE 

>saf>interface>iiK)deI-menu.lisp 

None 
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2.1.7.2 


IND-FIR-TABLE 


Type; 

Arguments: 
Outputs: 
CaUs; 
Called  by: 


I 

Description: 


>saf>interface>model-menu.lisp 

DEFSTRUCT 

0 

None 

BUILD-A-IND-FIR-TABLE 

>saf>interface>model-menu.lisp 

IND-FIR-TABLE-P 

>saf>interface>model-menu.lisp 

COPY-IND-FIR-TABLE 

>saf>interface>model-menu.lisp 

MAKE-IND-FIR-TABLE 

>saf>interface>model-menu.lisp 

None 


2.1.7.3  DIR-FIR-TABLE 


Type: 

Arguments; 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

DEFSTRUCT 

0 

None 

BUILD-A-DIR-FIR-TABLE 

>saf>interface>model-menu.lisp 

DIR-FIR-TABLE-P 

>saf>interface>model-menu.lisp 

COPY-DIR-FIR-TABLE 

>saf>interface>model-menu.lisp 

MAKE-DIR-FIR-TABLE 

>saf>interface>model-menu.lisp 

None 


2.1.7.4  MAKE-SIMHOST-READTABLE 


Type: 

Arguments: 

Outputs: 

Calls: 


>saf>interface>model-menu.lisp 

Function 

0 

None 
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Called  by: 


Description: 


2.1.7.5 


Type: 

Arguments: 

Outputs: 

CaUs: 

Called  by: 
Description: 


2.1.7.6 


Type: 

Arguments: 

Outputs: 

Calls: 


(METHOD  REPLACE-ELEMENT  OBJECT-MS-PANE) 

>saf>interface>object-inenu.lisp 

(METHOD  TOP-LEVEL  OBJECT-MENU) 

>saf>interface>object-menu.lisp 

MAKE-OBJECr-FE£-DICnONARY 

>saf>interfacex)bject-menu.lisp 

REVERT-TO-FACTORY-FILE 

>saf>interface>object'menu.lisp 

MAKE-HITMODELS-DICnONARY 

>saf>inteiface>model'inenu.lisp 

None 


♦SAVE-READTABLE* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

None 

None 


MAKE-HITMODELS-DICTIONARY 


>saf>interface>model-menu.lisp 

Function 

0 

WITH-AUTOMATIC-LCXjIN 

>saf>sys>macros.lisp  _ 

WITH-OPEN-FILE-ON-BUTIERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>  macros.lisp 

♦HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 

♦HIT-FILE-NAME* 

>saf>interfacc>model-mcnu.lisp 

SELECT-HOST 

>saf>inteifacc>model-menu.lisp 

MAKE-SIMHOST-READTABLE 

>saf>interface>model-menu.lisp 

ELIMINATE-DUPUCATES 

>saf>interface>model-menu.lisp 
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Called  by: 
Description: 


MAKE-DICnONARY-PAIRS 
>saf>interface>model-nienu.lisp 
(METHOD  TOP-LEVEL  MODEL-MENU) 
>saf>interface>iiK)del-menu.]isp 
None 


2.1.7.7  ELIMINATE-DUPLICATES 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Function 

(LIST-OF-PAIRS) 

None 

GET-FORMATION-CHOICES 

>saf>inteTface>formations.lisp 

GET-VEHICLE-CHOICES 

>saf>interface>formations.lisp 

MAKE-OBJECT-FILE-DICnONARY 

>saf>inteiface>object-menu.lisp 

MAKE-HTTMODELS-DICnONARY 

>saf>interface>model-menu.lisp 

None 


2. 1.7.8  MAKE-DICTIONARY-PAIRS 


Type: 

Arguments: 

Outputs: 

CMs: 


Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Function 

(FORMS) 

MKATOM 

>saf>sys>new-storage.lisp 

CONCAT 

>saf>sys>new-storage.lisp 

MAKE-DICTIONARY-PAIRS 

>saf>interface>model-menu.lisp 

MAKE-OBJECr-FILE-DICnONARY 

>saf>interface>object-menu.lisp 

MAKE-DICnONARY-PAIRS 

>saf>inteiface>model-menu.lisp 

MAKE-HITMODELS-DICnONARY 

>saf>interface>model-menu.lisp 

None 
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2.1.7.9  COPY-LIST-ALL-LEVELS 


Type: 

Arguments: 

Oitputs: 

CMs: 

Called  by: 


Description: 


2.1.7.10  RESTORE-UPLOWCASE 


>saf>interface>model-menu.lisp 

Function 

(FORMS  DICTIONARY) 

RESTORE-UPLOWCASE 

>saf>interface>model-menu.lisp 

LOOIOIP-DICnONARY 

>saf>inteiface>model-menu.lisp 

WRITE-HTT-DATA-FILE 

>saf>interface>model-menu.lisp 

RESTORE-UPLOWCASE 

>saf>interface>model-menu.lisp 

None 


2.1.7.11  LOOKUP-DICTIONARY 


>saL>interface>model-menu.lisp 
Type:  Function 

Arguments:  (TOKEN  DICTIONARY) 

Outputs: 

Calls:  None 

Called  by:  RESTORE-UPLOWCASE 

>saf^interface>model-menu.lisp 
None 


>saf>inteiface>model-menu.lisp 

Function 

(LST) 

COPY-UST-ALL^LEVELS 

>saf^interface>model-menu.lisp 

(METOCH)  TOP-LEVEL  CONHGURATION-MENU) 

>saf>interfaoe>formations.lisp 

(METHOD  TOP-LEVEL  OBJECT-MENU) 

>sa£>inteiface>object-menu.lisp 

REVERT-TO-FACTORY-FILE 

>sa£>inteiface>object-menu.]isp 

COPY-UST-ALL-LEVELS 

>saf>interface>model-menu.Iisp 

None 
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2.1.7.12 


Type: 

Arguments; 

Ou^uts: 

CaUs: 


CaUedby: 


Description: 


2.1.7.13 


Type: 

Arguments: 

Outputs: 


READ-HIT.DATA 


>sa£>inteiface>model-menu.lisp 

Function 

(&OPTIONAL  (FILE-NAME  NIL)) 

♦HOST-FOR-CONHG-DATA* 

>sa£>sys>interim-modeLlisp 

♦TABLE-TYPE* 

>saf^inteiface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>interface>nKxlel-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>safi>inteiface>model-menu.lisp 

♦HIT-FILE-NAME* 

>safb>interface>model-menu.lisp 

♦HIT-TABLES* 

>saf>interface>model-menu.Iisp 

READ-HTT-DATA-FILE 

>saf>inteiface>model-menu.lisp 

GET-TABLE 

>saf>inteiface>model-menu.lisp 

SET-CURRENT-MODEL 

>sa£>inteiface>model-menu.lisp 

REVERT-TO-FACrORY-VERSION 

>saf>inteiface>model-menu.lisp 

DISPATCH-TO-TABLE 

>saf>interface>modeI-menu.lisp 

None 


READ-HIT-DATA-FILE 


>saf>inteiface>model-menu.lisp 

Function 

(FILE-NAME) 
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Calls: 


Called  by: 
Description: 


2.1.7.14 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


2.1.7.15 


Type: 

Arguments: 

Outputs: 

Calls: 


WTIH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WnH-OPEN-FILE-ON-BinTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macios.lisp 

♦WEAPON-NAME* 

>saf>intetface>model-menu.lisp 

READ-HTT-DATA-FILE-AUX 

>saf^inteiface>model-menu.lisp 

READ-HIT-DATA 

>sa£>inteiface>model-menu.lisp 

read  data  file  and  return  a  list  of  data  structures 


READ-HIT-DATA-FILE-AUX 


>saf>interface>model-menu.lisp 

Function 

(HIT-DATA) 

READ-HTT-DATA-FILE-AUX 

>saf>inteiface>model-menu.lisp 

BUILD-A-HTT-TABLE 

>saf>interface>model-menu.lisp 

READ-HTT-DATA-FILE-AUX 

>saf>interface>model-menu.Usp 

READ-HTT-DATA-FILE 

>saf>interface>model-menu.lisp 

None 


READ-GROUND-DETECTION-DATA 


>saf>inteiface>modei-inenu.lisp 

Function 

(&OPTIONAL  (FILE-NAME  NIL)) 

♦HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>intetface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>sa£>inteiface>model-menu.lisp 
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♦DETECnON-FILE-NAME* 

>saf^inteiface>model-menu.lisp 

♦HIT-TABLES* 

>saf>inteiface>model-menu.lisp 

REAEMjROUND-DATA-FROM-FILE 

>saf>intaface>model-inenu.lisp 

GET-TABLE 

>saf!>intetface>model-menu.lisp 
SET-CURRENT-MODEL 
>saf>iiiterface>model-menu.lisp 
Called  by:  REVERT-TO-FACTORY-VERSION 

>saf>inteiface>model-nienu.lisp 
DISPATCH-TO-TABLE 
>saf^inteiface>model'menu.lisp 
Description:  None 


2.1.7.16  READ-GROUND-DATA-FROM-FILE 


>saf>interface>model-menu.lisp 
Type:  Function 

Arguments:  (FILE-NAME) 

Outputs: 

Calls:  WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp  _ 

WITH-OPEN-FILE-ON-BinTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

*WEAPON-NAME* 

>saf>interface>model-menu.lisp 
BUILD-A-HTT-TABLE 
>saf>interface>model-menu.lisp 
Called  by:  READOROUND-DETECnON-DATA 

>saf>interface>model-inenu.lisp 

Description:  \  D,#TDlPs-T  [Begin  using  OOSs  escapes]\(l  0  (NIL  0) 

(Nn-:BOLD  NH^)  "CTTFONTCB")iead  data  file  and  return  a 
list  of  data  structuresNO 
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2.1.7.17  READ-AIR’DETECTION-DATA 


Type: 

Arguments: 

C)uq)uts: 

CMs: 


Called  by: 


Description: 


>saf>inteTface>model*menu.Iisp 

Function 

(AOPnONAL  (FILE-NAME  NIL)) 

♦HOST-FOR-CONHG-DATA* 

>saf^sys>interim-model.Usp 

♦TABLE-TYPE* 

>saf>interface>model-menu.li^ 

♦WEAPON-NAME* 

>sa£>intetface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

♦DETECnON-FE^-NAME* 

>saf>inteiface>model-menu.lisp 

♦HIT-TABLES* 

>sa£>interface>inodel-menu.lisp 

READ-AIR-DATA-FROM-FILE 

>saf>interface>modet-menu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

SET-CURRENT.MODEL 

>saf>interface>iiiodet'menu.lisp 

REVERT-TO-FACrORY-VERSION 

>saf>inteiface>inodel-menu.lisp 

DISPATCH-TaTABLE 

>saf>interface>model-inenu.lisp 

None 


2.1.7.18  READ-AIR-DATA-FROM-FILE 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


>saf>interface>nK)deI-menu.lisp 

Function 

(FILE-NAME) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>niacios.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

♦WEAPON-NAME* 

>saf>interface>inodel-menu.lisp 

BUILD-A-HIT-TABIJE 

>saf>inteiface>model-nienu.lisp 

READ-AIR-DETECnON-DATA 

>saf>inteTface>model-inenu.lisp 

Mread  data  file  and  return  a  list  of  data  structuresNO 
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2.1.7.19  READ-INDIRECT.FIRE-DAMAGE.DATA 


Type: 

Arguments: 

Ou^uts: 

CaUs: 


Called  by: 

Description: 


>saf!>intaface>model-menu.lisp 

FunctkMi 

(&OPnONAL  (FILE-NAME  NBL)) 

WITH-AUTOMATIC-IjCXjIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BinTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

*HOST-FOR-CONHG-DATA* 

>saf>sys>inteiim-modeLlisp 

CONCAT 

>saf>sys>new-storage.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>interface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

♦INDIRECT-FIRE-DAMAGE-FILE-NAME* 

>saf>inteiface>model-menu.lisp 

♦IF- VEHICLE* 

>saf>interface>model-menu.lisp 

♦IND-FIR-TABLES* 

>saf>intciface>model-menu.lisp 

♦INDIRECr-FIRE-DAMAGE-DATA* 

>saf>inteiface>tnodel-menu.lisp 

FETCH-IF-DATA 

>saf>intetface>tnodel-menu.lisp 

GET-TABLE 

>saf>interface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>inteiface>model-menu.Iisp 

REVERT-TO-FACTORY-VERSION 

>saf>interface>model-menu.lisp 

DISPATCH-TO-TABLE 

>saf>inteiface>niodel-menu.lisp 

None 
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2.1.7.20 


Type: 

Arguments: 

Ouq)Uts: 

Calls: 


Called  by: 
Description: 


2.1.7.21 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


FETCH-IF-DATA 


>saf>interface>model-menu.lisp 

Function 

(VEHICLE-TYPE) 

CONCAT 

>saf>sys>new-storage.lisp 

♦INDIRECr-FIRE-DAMAGE-DATA* 

>saf!>intaface>model'menu.lisp 

BUILD-A-IND-FIR-TABLE 

>saf>inteiface>model-menu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model'menu.lisp 

None 


READ-INDIRECT-FIRE-DAMAGE-DATA-FROM-FILE 


>saf>interface>model-menu.lisp 

Function 

(FILE-NAME) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

*WEAPON-NAME* 

>saf>interface>model-menu.lisp 

BUILD-A-IND-FIR-TABLE 

>saf>inteiface>model-menu.lisp 

None 

Mread  data  Ele  and  return  a  list  of  data  structuresVO 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


2.1.7.22 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


READ-DIRECT-FIRE-DAMAGE-DATA 


>saf>inteiface>model'menu.lisp 

Function 

(&OPnONAL  (FILE-NAME  NIL)) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

♦HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 

CONCAT 

>saf>sys>new-storagcJisp 

♦PART* 

>saf>interface>model-menu.lisp 

♦ASPECT* 

>saf>interface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>interface>model-menu.lisp 

♦PARAMETER-DISPLAY-PANE* 

>saf>interface>modeI-menu.lisp 

♦DIRECT-HRE-DAMAGE-FILE-NAME* 

>saf>interface>model-menu.lisp 

♦DF- VEHICLE* 

>saf>interface>model-menu.lisp 

♦DIR-FIR-TABLES* 

>saf>inteiface>model'menu.lisp 

♦DIRECT-FIRE-DAMAGE-DATA* 

>saf>interface>model-menu.lisp 

FETCH-DF-DATA 

>saf>interface>modeI-menu.Iisp 

GET-TABLE 

>saf>inteiface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

REVERT-TaFACTORY-VERSION 

>saf>interface>model-menu.lisp 

DISPATCH-TO-TABLE 

>saf>interface>model-menu.lisp 

None 


94 


BBN  Systems  and  Technologies 


S AF  Parameter  Editor  CSQ 


2.1.7.23 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


2.1.7.24 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


2.1.7.25 


Type: 

Arguments: 

Outputs: 

Calls: 

Called  by: 


Description: 


FETCH-DF-DATA 


>saf>interface>model-menu.lisp 

Function 

(VEHICLE-TYPE) 

CONCAT 

>saf>sys>new-storage.lisp 

♦DIRECr-FIRE-DAMAGE-DATA* 

>saf>interface>model-menu.lisp 

BUILD-A-DIR-FIR-TABLE 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-menu.Iisp 

None 


READ-DIRECT-FIRE-DAMAGE-DATA-FROM-FILE 


>saf>interface>model-menu.lisp 

Function 

(FILE-NAME) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>macros.  lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

BUILD-A-DIR-FIR-TABLE 

>saf>inteiface>model-menu.lisp 

None 

\lread  data  file  and  return  a  list  of  data  structu^es^O 


BUILD-A-HIT-TABLE 


>saf>interface>modei-menu.lisp 

Function 

(HIT-DATA) 

HIT-TABLE 

>saf>interface>model-menu.lisp 

READ-AIR-DATA-FROM-FILE 

>saf>interface>model-menu.lisp 

READ-GROUND-DATA-FROM-FILE 

>saf>interface>model-menu.lisp 

READ-HTT-DATA-FILE-AUX 

>saf>interface>model-menu.lisp 

translates  butterfly  fomiat  of  hit  data  to  a  hit-table  structure 
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2.1.7.26  BUILD-A-DIR-FIR-TABLE 


Type: 

Arguments: 

Outputs: 

CaUs: 

CMedby: 


Description: 

structure 


>saf^interface>model-menu.lisp 

Function 

(T  2v-FIR-DATA  PART  ROUND) 

DIR-FIR-TABLE 

>saf>interface>model-menu.lisp 

READ-DIRECr-FIRE-DAMAGE-DATA-FROM-FILE 

>saf>interface>model'menu.lisp 

FETCH-DF-DATA 

>saf>inteiface>model-menu.Iisp 

translates  butterfly  format  of  dii^  fire  damage  data  to  a  dir-fir-table 


2.1.7.27  BUILD-A-IND-FIR-TABLE 


Type: 

>saf>interface>model-menu.lisp 

Function 

Arguments: 

(IND-FIR-DATA) 

Outputs: 

Calls: 

IND-FIR-TABLE 

Called  by: 

>saf>interface>model-menu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA-FROM-FILE 

Description: 

>saf>interface>model-menu.lisp 

FETCH-IF-DATA 

>saf>interface>model-menu.lisp 

translates  butterfly  format  of  imUrect  Are  damage  data  to  a  ind-fir- 

table  stmcture 

2.1.7.28  WRITE-CORRESPONDING-TABLE 


Type: 

Arguments: 

Ouq)uts: 

CMs: 


Called  by: 
MENU) 


>saf>interface>model-menu.lisp 

Function 

0 

*TABLE-TYPE* 

>saf>interface>model-menu.lisp 

WRITE-HIT-DATA 

>saf>interface>model-menu.lisp 

WRITE-DETECnON-DATA 

>saf>inteiface>model-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA 

>saf>inteTface>model-menu.lisp 

WRITE-DIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

(METHOD  COM-WRTTE-TABLE-IND-INTERNAL  MODEL- 
No  Source  File  Record 
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MENU) 


Description: 


2.1.7.29 


Type: 

Arguments: 
Outputs: 
CaUs: 
Called  by: 


Description: 


2.1.7.30 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


(METHOD  COM-WRTTE-TABLE-DIR-INTERNAL  MODEL- 
No  Source  File  Record 

(METHOD  CX)M-WRnE-TABLE-INTERNAL  MODEL-MENU) 

No  Source  File  Record 

None 


♦DEVELOPERS-FLG* 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

WRITE-CONnOURATION-FILE 

>saf>interface>formations.lisp 

WRITE-OBJECT-FILE 

>saf>interface>object-menu.lisp 

WRITE-DIRECr-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-DETECnON-DATA-FILE 

>saf>intetface>model-menu.lisp 

WRITE-HTT-DATA-FILE 

>saf>interface>model-menu.lisp 

None 


WRITE-HIT-DATA 


>saf>interface>modeI-menu.lisp 

Function 

0 

♦HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 

♦HIT-FILE-NAME* 

>saf>interface>model-menu.lisp 

WRITE-HTT-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-CORRESPONDING-TABLE 

>saf>interface>model-menu.lisp 

None 
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2.1.7.31  WRITE-HIT-DATA-FILE 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 
Description: 


>saf>interface>model-menu.lisp 

Function 

(FILE-NAME) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

WITH-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

*HIT-TABLES* 

>saf>interface>model-menu.lisp 

♦HTTMODELS-DICnONARY* 

>saf>interface>model-menu.lisp 

RESTORE-UPLOWCASE 

>saf>interface>model-menu.lisp 

♦DEVELOPERS-FLG* 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>interface>model-menu.lisp 

REMEMBER-CURRENT-HIT-TABLE 

>saf>interface>model-menu.lisp 

WRITE-HIT-DATA 

>saf>inteTface>model-menu.Usp 

write  all  hit-tables  to  the  passed  file 


2.1.7.32  WRITE-DETECTION-DATA 


Type: 

Arguments: 

Output 

Calls: 


CMedby: 

Description: 


>saf>interface>model-menu.lisp 

Function 

0 

♦HOST-FOR-CONHO-DATA* 

>saf>sys>interim-modeI.lisp 

♦DETECnON-FILE-NAME* 

>saf>interface>model-menu.lisp 

WRITE-DETECTION-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-CX)RRESPONDING-TABLE 

>saf>interface>modeI-menu.lisp 

None 


98 


BBN  Systems  and  Technologies 


S  AF  Parameter  Editor  CSCI 


2.1 


.7.33 


WRITE-DETECTION-DATA-FILE 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 
Description: 


>saf>inteiface>model-menu.lisp 

Function 

(FILE-NAME) 

Wrm-AUTOMATIC-LOGIN 

>saf>sys>niacros.lisp 

Wrm-OPEN-FILE-ON-BUTTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>inacros.lisp 

*TABLE-TYPE* 

>saf>inteiface>model-menu.lisp 

♦HIT-TABLES* 

>saf>interface>model-n)enu.lisp 

♦DEVELOPERS-FLG* 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>interface>model-menu.lisp 

REMEMBER-CURRENT-HTT-TABLE 

>saf>interface>model-menu.lisp 

WRITE-DETECnON-DATA 

>saf>interface>model-menu.lisp 

None 


2. 


1.7.34 


WRITE-INDIRECT-FIRE-DAMAGE-DATA 


Type: 

Arguments: 

Outputs: 

CaUs: 


Clalledby: 

Description: 


>saf>interface>model-menu.lisp 

Function 

0 

♦HOST-FOR-CONFIG-DATA* 

>saf>sys>interim-model.lisp 

♦INDIRECT-FIRE-DAMAGE-FILE-NAME* 

>saf>interface>model-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-CORRESPONDING-TABLE 

>saf>interface>model-menu.lisp 

None 
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2.1.7.35  WRITE-INDIRECT-FIRE-DAMAGE-DATA-FILE 


>saf>interface>model-menu.lisp 
Type:  Function 

Arguments:  (FILE-NAME) 

Outputs: 

Calls:  WrrH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 
Wrm-OPEN-FILE-ON-BinTERFLY 
>saf>sys>macros.lisp 
HANDLE-LOGIN 
>saf>sys>macros.lisp 
MKATOM 

>saf>sys>new-storage.lisp 
♦IF- VEHICLE* 

>saf>interface>model-menu.lisp 

♦IND-FIR-TABLES* 

>saf>interface>model-menu.lisp 

♦INDIRECr-FIRE-DAMAGE-DATA* 

>saf>interface>model-menu.lisp 

♦DEVELOPERS-FLG* 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

Called  by:  WRlTE-INDIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 
Description:  None 


2.1.7.36  WRITE-DIRECT-FIRE-DAMAGE-DATA 


>saf>interface>modei-menu.lisp 
Type:  Function 

Arguments:  () 

Outputs: 

Calls:  *HOST-FOR-CONHG-DATA* 

>saf>sys>interim-model.lisp 
♦DIRECT-FIRE-DAMAGE-FILE-NAME* 
>saf>interface>model-menu.lisp 
WRITE-DIRECr-FIRE-DAMAGE-DATA-FIUE 
>saf>inteiface>model-menu.lisp 
Called  by:  WRITE-CORRESPONDING-TABLE 

>saf>interface>model-menu.lisp 
Description:  None 
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2.1.7.37 


Type: 

Arguments; 

Outputs: 

Calls: 


Called  by: 
Description: 


2.1.7.38 


Type: 

Arguments: 

Outputs: 

Calls: 


WRITE-DIRECT-FIRE-DAMAGE-DATA-FILE 


>saf>interface>model-menu.lisp 

Function 

(FILE-NAME) 

WITH-AUTOMATIC-LOGIN 

>saf>sys>macros.lisp 

Wrra-OPEN-FILE-ON-BinTERFLY 

>saf>sys>macros.lisp 

HANDLE-LOGIN 

>saf>sys>macros.lisp 

MKATOM 

>saf>sys>new-storagc.lisp 

♦DF- VEHICLE* 

>saf>interface>model-menu.lisp 

♦DIR-FIR-TABLES* 

>saf>interface>model-menu.lisp 

*DIRECT-FIRE-DAMAGE-DATA* 

>saf>interface>model-menu.lisp 

♦DEVELOPERS-FLG* 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>inteTface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

WRITE-DIRECr-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

None 


GATHER-DATABASE 


>saf>interface>model-menu.lisp 

Function 

(LIST-OF-TABLES) 

♦IND-FIR-TABLES* 

>saf>interface>model-menu.lisp 

♦DIR-FIR-TABLES* 

>saf>interface>nKxlel-menu.lisp 

GATHER-INDIRECT-FIRE-DATABASE 

>saf>inteTface>model-menu.lisp 

GATHER-DIRECr-FIRE-DATABASE 

>saf>interface>model-menu.lisp 
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Called  by: 


Description: 


2.1.7.39 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


2.1.7.40 


Type: 

Arguments: 
Outputs: 
Calls: 
Called  by: 

Description: 


2.1.7.41 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 
Description: 


WRITE-DIRECr-FIRE-DAMAGE-DATAnLE 

>saf>interface>model-menu.lisp 

WRTIE-INDIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>nx)del-menu.lisp 

WRITE-DETECnON-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-HIT-DATA-FILE 

>saf>interface>model-menu.lisp 

None 


GATHER-INDIRECT-FIRE-DATABASE 


>saf>interface>model-menu.lisp 

Function 

0 

♦IND-FIR-TABLES* 

>saf>interface>model-menu.lisp 

EXTRACT-RANGE-AND-DICE-NUMBERS 

>saf>inteiface>modei-menu.lisp 

GATHER-DATABASE 

>saf>interface>modeI-menu.lisp 

None 


EXTRACT-RANGE-AND-DICE-NUMBERS 


>saf>imerface>model-menu.lisp 

Function 

(TABLE) 

None 

GATHER-INDIRECT-FIRE-DATABASE 

>saf>interface>model-menu.lisp 

None 


GATHER-DIRECT-FIRE-DATABASE 


>saf>inteiface>model-menu.lisp 

Function 

0 

*DIR-FIR-TABLES* 

>saf>interface>modeI-menu.lisp 

EXTRACT-DICE-NUMBERS 

>saf>interface>model-menu.lisp 

GATHER-DATABASE 

>saf>interface>model-menu.lisp 

None 
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2.1.7.42 


Type: 

Arguments: 
Ou^uts: 
Calls: 
Called  by: 

Description: 


2.1.7.43 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


EXTRACT-DICE-NUMBERS 


>saf>interface>model-menu.lisp 

Function 

(TABLE) 

None 

GATOER-DIRECT-FIRE-DATABASE 

>sa£>interface>model-menu.Iisp 

Makes  loU-of-the-dice  numbers  for  the  simhost  config  file 


GET-TABLE 


>saf>interface>model-menu.lisp 

Function 

(NAME  &OPTIONAL  (TABLE-UST  *HIT-TABLES*)) 
♦PART* 

>saf>inteTface>model-menu.lisp 

♦ASPECT* 

>saf>interface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>intcrfacc>model-menu.lisp 

♦HIT-TABLES* 

>saf>interface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 

READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>inteiface>model-menu.lisp 

READ-INDIRECT-FIRE-DAMAGE-DATA 

>saf>interface>model-menu.lisp 

READ-AIR-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READOROUND-DETECnON-DATA 

>saf>interface>model-menu.lisp 

READ-HIT-DATA 

>saf>interface>model-menu.lisp 

USER-SELECT-ASPECT 

>saf>inteiface>model-menu.lisp 

USER-SELECT-MODEL 

>saf>interface>model-menu.lisp 

GRAPH-UNDO 

>saf>interface>model-menu.lisp 

None 
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2.1.7.44 


Type; 

Arguments; 

TABLES*)) 

Outputs; 

CaUs; 


Called  by; 


Description: 


2.1.7.45 


Type: 

Arguments: 

Outputs; 

Calls: 


CaUed  by: 


GET-HIT-TABLE 


>saf>interface>model-menu.lisp 

Function 

(NAME  &KEY  (SHOULD-FIND  NIL)  (HIT-TABLES  *HIT- 


♦HIT-TABLES* 

>saf>inteTface>nxxlel-menu.lisp 

GET-HIT-TABLE 

>saf>interface>model-menu.lisp 

GET-NEW-WEAPON-NAME 

>saf>interface>model-menu.lisp 

REMEMBER-CURRENT-HIT-TABLE 

>saf>inteiface>model-menu.lisp 

GET-HIT-TABLE 

>saf>interface>modeI-menu.lisp 

None 


REMEMBER-TABLE 


>saf>inteiface>model-menu.lisp 

Function 

(&OPTIONAL  (CURRENT-TABLE-LIST  ♦HIT-TABLES*)) 

♦HULL-POINTS* 

>saf>interface>modeI-menu.lisp 

♦STATIONARY-POINTS* 

>saf>interface>model-menu.lisp 

♦MOVING-POINTS* 

>saf>interface>model-menu.lisp 

♦CATASTROPHIC-POINTS* 

>saf>interface>modeI-menu.lisp 

♦MOBILITY-POINTS* 

>saf>inteiface>modeI-menu.lisp 

♦HREPOWER-FOINTS* 

>saf>inteiface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>interface>tnodel-menu.lisp 

♦WEAPON-NAME* 

>saf>interface>mode!-menu.lisp 

♦HIT-TABLES* 

>saf>interface>model-menu.lisp 

GET-TABLE 

>saf>interface>tnodel-menu.lisp 

MAKE-UNDOTTED-SUBLISTS 

>saf>interface>model-menu.lisp 

WRITE-DIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 

WRITE-INDIRECT-FIRE-DAMAGE-DATA-FILE 

>saf>interface>model-menu.lisp 
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Description: 


2.1.7.46 


Type: 

Arguments: 

Outputs: 

CaUs: 


Called  by: 


Description: 


2.1.7.47 


Type: 

Arguments: 

OuQjuts: 

Calls: 

Called  by: 


Description: 


USER-SELECT-ASPECr 

>saf>interface>model-menu.lisp 

USER-SELECT-MODEL 

>saf>interface>model-menu.lisp 

None 


REMEMBER-CURRENT.HIT-TABLE 


>saf>inteTface>model-menu.lisp 

Function 

0 

♦HULL-POINTS* 

>saf>interface>model-menu.lisp 

♦STATIONARY-POINTS* 

>saf>interfacc>model-menu.lisp 

♦MOVING-POINTS* 

>saf>inteTface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>inteiface>model-menu.lisp 

GET-HIT-TABLE 

>saf>interface>model-menu.Iisp 

MAKE-UNDOTTED-SUBLISTS 

>saf>interface>model-menu.lisp 

WRITE-DETECnON-DATA-FILE 

>saf>inteTface>model-menu.lisp 

WRITE-HTT-DATA-FILE 

>saf>interface>modeI-menu.Iisp 

None 


MAKE-DOTTED-SUBLISTS 


>saf>inteiface>model-menu.lisp 

Function 

(LIST) 

MAKE-DOITED-SUBLISTS 

>saf>interface>modeI-menu.Iisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.Iisp 

MAKE-DOTTED-SUBLISTS 

>saf>interface>model-inenu.lisp 

None 
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2.1.7.48  MAKE-UNDOTTED-SUBLISTS 


Type: 

Arguments: 

Outputs: 

CaUs: 

CaUedby: 


>saf>interface>modeI-menu.lisp 

Function 

(LIST) 

MAKE-UNDOTTED-SUBUSTS 

>saf>interface>model-menu.lisp 

MAKE-UNDOTTED-SUBUSTS 

>sa£>inteiface>model-menu.lisp 


REMEMBER-CURRENT-HIT-TABLE 

>safb>inteiface>model-menu.lisp 

REMEMBER-TABLE 

>saf>interface>model-menu.lisp 


Description: 

None 

2.1.7.49 

QUERY-WINDOW 

Type: 

>saf>inteiface>model-ntenu.lisp 

Flavor 

Arguments: 

0 

Outputs: 

Calls: 

None 

Called  by: 

None 

Description: 

None 

2.1.7.50 

♦DEFAULT-FILE-NAME* 

Type: 

>saf>interface>model-menu.lisp 

Variable 

Arguments: 

0 

Outputs: 

(Tails: 

None 

Called  by: 

QUERY-FOR-FILENAME 

Description: 

>saf>inteiface>model-roenu.lisp 

None 
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2. 


1.7.51 


•QUERY-WINDOW* 


Type: 

Arguments: 
Ouq)uts: 
CMs: 
Called  by: 


Desciipdon: 


>saf>interface>model-menu.lisp 

Parameter 

0 

None 

GET-NEW-WEAPON-NAME 

>saf>inteiface>model-menu.lisp 

QUERY-FOR-FILENAME 

>saf>inteiface>model-menu.lisp 

QUERY-USER 

>saf>interface>model-menu.lisp 

None 


2.1.7.52  QUERY-USER 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


>saf>interface>model-menu.lisp 

Macro 

(DATA-TYPE  &REST  KEYWORD- VALUE-PAIRS) 

♦QUERY-WINDOW* 

>^>interface>model-menu.lisp 

QUERY-USER 

>saf>interface>model-menu.lisp 

GET-NEW-WEAPON-NAME 

>saf>interface>modei-menu.lisp 

QUERY-FOR-HLENAME 

>saf>interface>model-menu.lisp 

QUERY-USER 

>saf>interface>model-menu.lisp 

None 


2.1.7.53  QUERY-FOR-FILENAME 


>saf>inteTface>model-menu.lisp 

Function 

(PROMPT  &OPTIONAL  (DEFAULT-FILE  *DEFAULT-FILE- 


♦DEFAULT-FILE-NAME* 

>saf>interface>model-menu.lisp 

♦QUERY-WINDOW* 

>^>interface>model-menu.lisp 


Type: 

Arguments: 

NAME*)) 

Ou4)uts: 

Calls: 
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QUERY-USER 

>saf>interface>model'menu.lisp 
Called  by:  None 

Description:  None 


2.1.7.54  GET-NEW-WEAPON-NAME 


Type: 

Arguments: 

Outputs: 


Calls: 


Called  by: 
Description: 


>saf>inteiface>tnodel'menu.lisp 

Function 

0 

GET-HTT-TABLE 

>saf>intetface>model-menu.lisp 

♦QUERY-WINDOW* 

>^>interface>model-menu.lisp 

QUERY-USER 

>saf>intetface>model-menu.lisp 
USER-SELECT-MODEL 
>saf>interface>model-menu.lisp 
get  weapon  system  name  from  user 


2.1.8  High  level  functions 

[; ; ;  High  level  functions  ] 

The  function  SET-CURRENT-MODEL  sets  up  the  basic  lists  *NAME-points*  and 
♦NAME-graph*  (defined  in  the  Parameters  CSU),  sets  up  the  appropriate  frame 
configuration,  and  calls  PRESENT-DATA  to  do  iht  woric. 

PRESENT-DATA  calls  CLEAN-UP-AXIS-AND-REDRAW  and  PRESENT-GRAPH  to 
plot  the  probability  data,  and  then  constructs  and  displays  the  appropriate  title  in  the  black 
title  pane.  Finally,  it  calls  PRESENT-TABLE  to  display  the  probability  data  in  tabular 
form, 

PRESENT-TABLE  relies  on  system-provided  macros  to  format  the  data  in  tabular  form. 


2.1.8.1  SET-CURRENT-MODEL 


>saf>interface>model-menu.lisp 
Type:  Function 

Arguments:  (WINDOW  TABLE) 
Outputs: 

Calls:  *OLD-SELECTION* 

>saf>interface>model-menu.lisp 

♦HULL-GRAPH* 

>saf>interface>model-menu.lisp 

♦STATIONARY-GRAPH* 

>saf>interface>model-menu  .li  sp 

♦MOVING-GRAPH* 
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>saf>inteiface>model-menu.lisp 

♦CATASTROPHIC-GRAPH* 

>saf>inteiface>model-inenu.lisp 

♦MOBILITY-GRAPH* 

>saf>interface>model-inenu.lisp 

♦RREPOWER-GRAPH* 

>saf>interface>model-inenu.lisp 

♦HULL-POINTS* 

>saf>inteiface>inodel-menu.lisp 

♦STATIONARY-POINTS* 

>sa^interface>model-menu.Usp 

♦MOVING-POINTS* 

>saf>interface>inodel-inenu.lisp 

♦CATASTROPHIC-POINTS* 

>saf>interface>inodel-menu.lisp 

♦MOBILITY-POINTS* 

>saf>interface>model-inenu.Usp 

♦HREPOWER-POINTS* 

>saf>interface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦MODE* 

>saf>interface>model-menu.Iisp 
♦WEAPON-NAME* 
>saf>interface>model-menu.lisp 
♦GRAPH-BEFORE-LAST-STEP* 
>saf>inteTface>model-inenu.lisp 
MAKE-GRAPH-GIVEN-POINTS 
>saf>interface>model-menu.lisp 
MAKE-DOTTED-SUBUSTS 
>saf>interface>nK)del-inenu.lisp 
HIGHLIGHT-SELECTION 
>saf>interface>inodel-menu.lisp 
PRESENT-DATA 
>saf>interface>model-inenu.lisp 
Called  by:  READ-DIRECT-FIRE-DAMAGE-DATA 

>saf>interface>modeI-menu.lisp 
READ-INDIRECT-FIRE-DAMAGE-DATA 
>saf>interface>model-menu.lisp 
READ-AIR-DETECnON-DATA 
>saf>interface>model-menu.lisp 
READ-GROUND-DETECTION-DATA 
>saf>interface>inodel-menu.lisp 
READ-HIT-DATA 
>saf>interface>inodel-tnenu.lisp 
USER-SELECT-ASPECT 
>saf>inteTface>model-menu.lisp 
USER-SELECT-MODEL 
>saf>interface>model-tnenu.lisp 
GRAPH-UNDO 
>saf>interface>model-menu.lisp 
Description:  None 
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2.1.8.2 


Type: 

Arguments: 

Outputs: 

CMs: 


Called  by: 
Description: 


2.1.8.3 


Type: 

Arguments: 

Outputs: 

Calls: 


HIGHLIGHT-SELECTION 


>saf>interface>nKxleI-menu  lisp 
Function 
0 

HIGHLIGHT-BUTTON- 1 

>saf>ui>frame-utils.lisp 

*OLD-SELECnON* 

>saf>inteiface>model-menu.lisp 

SET-CURRENT-MODEL 

>saf>interface>model-menu.lisp 

None 


PRESENT-DATA 


>saf>interface>model-menu.lisp 

Function 

(GRAPH  WINDOW  &OPTIONAL  (CLEAR-WINDOW  NIL)) 
♦PART* 

>saf>interface>model-menu.lisp 

♦ASPECT* 

>saf>interface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>interface>model-menu.lisp 

♦WEAPON-NAME* 

>saf>interface>model-menu.lisp 

♦TABULAR-DISPLAY-PANE* 

>saf>interface>model-menu.lisp 

♦DISPLAY-LOGO-PANE* 

>saf>inteiface>model-menu.lisp 

♦TABULAR-LOGO-PANE* 

>saf>interface>modeI-menu.lisp 

♦INDIRECT-FIRE-DAMAGE-FILE-NAME* 

>saf>interface>model-menu.lisp 

♦DIRECT-FIRE-DAMAGE-FILE-NAME* 

>saf>inteiface>model-menu.lisp 

DRAW-SCALE-BAR 

>saf>interface>model-menu.lisp 

DRAW-X-TICKS 

>saf>interface>model-inenu.lisp 

DRAW-Y-TICKS 

>saf>interface>modeI-menu.lisp 

DRAW-TICKS 

>saf>interface>model-menu.lisp 

CLEAN-UP-AXIS-AND-REDRAW 

>saf>interface>model-menu.lisp 

PRESENT-GRAPH 

>saf>interface>modcl-menu.lisp 

GET-PLATFORM 
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Called  by: 


Description; 

2.1.8.4 


Type: 

Arguments: 

Outputs: 

CaUs: 

Called  by: 
Description: 


>saf>interface>model-menu.lisp 

PRESENT-TABLE 

>saf>interface>modeI-menu.lisp 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT- 1) 
No  Source  File  Record 

(PRESENTATION-MOUSE-HANDLER  INSERT-POINT) 

No  Source  File  Record 

SET-CURRENT-MODEL 

>saf>intcrfacc>model-menu.lisp 

(METHOD  ALTER-PROBABILITY  POINT) 

>saf>interface>modeI-menu.Iisp 

(METHOD  ALTER-RANGE  POINT) 

>saf>interface>model-menu.Iisp 

(METHOD  DRAG-UP-DOWN  POINT) 

>saf>interface>model-menu.lisp 

CHANGE-MODE 

>saf>interface>model-menu.lisp 

GO-BACK-TO-PREVIOUS-STEP 

>saf>interface>model-menu.lisp 

(METHOD  DRAG  POINT) 

>saf>interface>model-menu.lisp 
graph  and  tabular  display 


GET-PLATFORM 


>saf>interface>model-menu.lisp 

Function 

(FILE-NAME) 

♦DF- VEHICLE* 
>saf>interface>model-menu.lisp 
♦IF- VEHICLE* 

>saf>interface>modeI-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

None 
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2.1.8.5 


Type: 

Arguments: 

Outputs: 

Calls: 


Called  by: 


Description: 


PRESENT-TABLE 


>saf>interface>model-menu.lisp 

Function 

(GRAPH  WINDOW) 

POINT 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

♦TABLE-TYPE* 

>saf>inteiface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

POINT 

>saf>interface>model-menu.lisp 

RANGE 

>saf>interface>model-menu.lisp 

PROBABILITY 

>saf>interface>model-menu.lisp 

PRESENT-DATA 

>saf>interface>model-menu.lisp 

ADD-CORRESPONDING-NEW-POINT-IN-POINT-LIST 

>saf>interface>model-menu.lisp 

DELETE-POINT-IF-THERE 

>saf>interface>model-menu.lisp 

None 
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2.2.  WEAPONS  SYSTEMS  EDITOR  CSC 

This  CSC  contains  the  code  which  allows  an  (^)erator  to  edit  weapons  systems  parameters. 
Weapons  systenos  are  vehicles,  guns,  missiles,  etc.  The  guns  and  missiles  are  separated 
from  the  vehicles  to  allow  the  user  to  interchange  weapons  from  different  vehicles.  The 
weapons  system  editOT  does  not  guarantee  a  valid  result  with  this  feature  but  the  restricucais 
are  fairly  sin:^)le.  The  primary  purpose  of  the  editor  is  to  allow  users  to  change  parameters 
such  a  weapon  ranges,  vehicle  spe^,  etc.  It  also  allows  the  comparison  of  different 
weapons. 

The  software  for  this  editor  is  found  the  file  saf>interface>object-menu.lisp. 

This  CSC  edits  the  Simhost  file: 
lusrlsqflcorfiglcorfigJisp. 


Figure  2.2-1  Weapons  Systems 


Editor  CSC  Structure 
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2.2.1.  File  I/O  Operations  CSIJ 

This  CSU  contains  the  functions  that  perform  input-output  operations  between  the  Simhost 
file  containing  the  weapon  systems  parameter  data  and  ^e  editor. 

Function  READ-OBJECT-FILE: 

The  purpose  of  this  function  is  to  read  the  Simhost  file  ls(^config/corrfig.lisp  into  the 
editor.  The  file  ccmtains  parameter  setting  for  all  weapon  systems  used  by  the  semi- 
automated  forces. 

The  procedure  that  this  function  follows  is  to  first  construct  a  file  access  string  using  the 
Simnet  Host  to  which  the  battlemaster  is  connected.  When  the  NIL  argument  is  passed,  the 
default  lusrlscficor^glcoi0g.Usp  file  is  used.  The  operator  may  pass  as  an  argument  a 
pathway  string  to  an  alternative  data  file.  The  functitm  then  uses  WTIH-OPEN-FILE-ON- 
BUTTERFLY  to  open  the  file  and  input  its  contents  into  the  editor  as  a  list  structure,  setting 
the  global  ♦OBJECTS-FORMS*  to  this  list  structure. 

Function  WRITE-OBJECT-FILE: 

The  purpose  of  this  function  is  to  write  the  edited  versirai  of  the  configMsp  file  back  into 
the  Simhost  at  /sqficorrfigiconfig.lisp. 

The  Lisp  code  used  by  the  editws  ignores  upper-case/lower-case  differences.  The 
procedure  that  this  function  follows  is  to  first  call  the  function  RESTORE-UPLOWCASE 
to  restore  all  parameter  name  and  symbol  values  to  their  (Higinal  multicase  form.  The 
restored  data  is  then  written  into  the  SIMHOST  using  the  system  macro  WTTH-OPEN- 
FILE.  This  macro  requires  a  password.  However,  setting  Ae  global  ♦DEVELOPERS- 
FLG*  to  T  writes  the  file  using  WITH-OPEN-FILE-ON-BUTIERFLY  instead,  bypassing 
the  password  request. 

Function  PREPARE-OBJECT-DATA-FOR-MENU-USE: 

The  purpose  of  this  function  is  to  prepare  the  weapon  systems  data  for  usage  by  the  editor. 

The  procedure  that  this  function  follows  is  to  first  set  the  global  *OBJECT-NAMES*  to  a 
list  of  names  of  all  weapons  systems  if  the  file.  Next  it  sets  the  global  *OBJECT-TO- 
WINDOW-ASSOC*  to  a  list  of  pairs,  each  consisting  of  the  name  of  the  weapon  system 
being  edited  and  the  window  pane  on  which  it  is  displayed.  Finally,  it  sets  the  global 
♦OBJECT-DESCRIPTIONS*  to  the  list  of  descripttn^  of  the  various  data  items  in  the 
configMsp  file. 
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2.2.2.  Editor  Frame  CSU 

This  CSU  contains  the  functions  that  construct  and  maintain  the  editor  frame.  The  editor 
firame  is  an  assemblage  of  windows  constrained  to  fit  aspanes  within  a  rectangular  frame, 
sharing  a  common  input-ouq)ut  buffer. 


Flavor  OBJECT-GLOBAL-COMMAND-PANE: 

This  is  a  window  pane  favor  built  on  top  of  flavor  OBJECT-MS-PANE.  It  has  a  single 
instance  variable,  PANE-NAME,  and  sets  the  default  character  style  to  datum  (:fix  :bold 
rncMtnal). 


Flavor  TABLE-COMMAND-PANE: 

This  is  a  window  pane  favor  built  on  top  of  flavor  OBJECT-MS-PANE.  It  has  a  single 
instance  variable,  PANE-NAME,  and  sets  the  default  character  style  to  datum  (:fix  :told 
:normal). 


Flavor  OBJECT-MS-PANE: 

This  is  the  basic  window  pane  flavor  for  the  editor.  It  is  built  on  top  of  MS-PANE  (defined 
in  Model  Editor  CSC.  It  has  three  instance  variables;  COLUMN-VhDTH,  ITEM-LIST, 
and  LIST-OF-<ZHANGES.  COLUMN-WIDTH,  which  is  initially  set  to  the  global  variable 
♦COLUMN-WIDTH*,  controls  the  width  of  each  of  the  columns  of  alphanumeric  data  into 
which  the  panel  is  divided.  ITEM-LIST  is  a  list  of  all  the  parameter  name  value  pairs  that 
define  the  weapon  system.  LIST-OF-CHANGES  keeps  track  of  all  the  parameter  pairs  that 
have  changed  with  Ae  editor.  The  default  character  style  is  set  to  datum  (:fix  :bold  :small). 


Method  :REVERT-PANE  Of  The  Flavor  OBJECT-MS-PANE: 

This  method  restores  a  weapon  system  data  to  the  ctxiditions  that  existed  when  it  was  last 
saved.  This  is  invoked  by  an  operator  when  a  weapon  system  data  currently  being  modified 
has  deviated  sharply  from  the  desired  results. 

The  procedure  that  this  method  follows  is  to  first  clear  the  window  pane  by  invoking  the 
Lisp  system  method  :CLEAR-HISTORY,  initialize  the  instance  variables  ITEM-LIST  and 
LIST-OF-CHANGES,  and  then  send  the  STUFF-OBJECT-INTO-PANE  message  to  the 
constraining  frame  (which  is  the  value  returned  by  the  message  (send  self  :superior)),  with 
the  values  of  CATEGORY-NAME  and  of  the  ^obal  variable  ♦WORKED-ON-OBJECTT- 
FORMS*  as  arguments. 
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Method  :SAVE-rrEM-UST  Of  The  Havor  OBJECT-MS-PANE: 

The  purpose  of  this  method  is  to  keep  a  copy  of  the  original  (unedited)  list  of  parameter 
name  v^ue  pairs. 

The  procedure  that  this  rrrethod  uses  is  a  standard  CXJLLECT  loop. 

Method  :REPLA(ZE-ITEM  Of  The  Flavor  OBJECT-MS-PANE: 

The  purpose  of  this  method  is  to  replace  the  value  of  a  parameter. 

The  procedure  that  this  method  uses  is  to  search  ITEM-LIST  for  a  parameter  name  value 
pair  with  a  name  equal  to  FIELD  (an  argument  set  to  the  parameter  name  that  is  to  be 
replaced).  It  then  replaces  that  paramet^s  value  with  NEW- VALUE  (a  seccmd  parameter 
ccmtaining  the  replacement  value). 

Method  :REDISPLAY-PANE  Of  The  Flavor  OBJECT-MS-PANE: 

The  pu^se  of  this  method  is  to  erase  and  display  anew  the  weapon  systems'  parameter 
data  being  edited. 

The  procedure  that  this  method  uses  is  first  blank  the  pane  to  be  redisplayed  by  invc^g 
the  system's  :clear-history  method.  The  method  next  invokes  the  extensive  system  macro 
FORMAl'l  ^G-TABLE,  with  its  attendant  FORMATTING  ROWS  macros.  The  first  call 
to  FORMATTING-TABLE  displays  the  weapons  system's  name  in  the  top  center  of  the 
pane.  The  second  call  invt^es  a  loop  where  parameter  name  value  pairs  are  taken  four  at  a 
time  and  displayed  in  four  colunuis  in  a  single  row  (each  row  has  four  pairs).  The  first 
element  in  a  pair,  the  parameter  name  is  displayed  as  a  FIELD-ELEMENT  presentation 
using  the  system  function  PRESENT.  The  second  element,  the  parameter's  value,  is 
displayed  as  a  NUMBER-ELEMENT  presentation  if  it  is  a  number,  or  as  a  defaulty 
presentation  if  not  If  the  name  and/or  iht  value  are  alphanumeric,  the  function 
TRUNCATE-IF-NECTESSARY  is  called  to  ensure  they  fit  within  the  allotted  column 
width. 

Method  :EXPOSE  Of  The  Havor  TABLE-COMMAND-PANE: 

The  purpose  of  this  method  is  to  construct  the  mouse-sensitive  commands  that  enable  the 
editor  to  "Save"  a  weapon  system's  parameter  set,  "Undo"  the  last  change  made,  "Undo 
All"  changes,  and  close  a  pane. 

This  method  uses  the  system  function  PRESENT  after  the  pane  has  been  exposed,  but 
before  it  is  displayed,  to  display  the  appropriate  mouse-sensitive  presentation.  The  four 
commands  mentioned  in  the  previous  paragn^h  are  evenly  spread  in  the  center  of  the 
pane's  width  with  the  help  of  the  system  method  :SET-CURSPOS. 
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Method  :EXPOSE  Of  The  Havor  OB  JECT-GLOBAL-COMMAND-PANE: 

The  purpose  of  this  method  is  to  construct  the  mouse-sensitive  oxnmands  that  enable  the 
editor  to  "Write"  a  new  Simhost  cor^g.lisp  file,  "Revert"  to  a  factory  version  of  the 
configMsp  file  and  "Reset". 

This  method  uses  the  system  function  PRESENT  after  the  pane  has  been  exposed,  but 
before  it  is  displayed,  to  display  the  appropriate  mouse-sensitive  presentatiem.  The  three 
ccxnmands  mentioned  in  the  previous  paragraph  are  evenly  spread  in  the  center  75%  of  the 
pane's  width  with  the  help  of  the  system  method  rSET-CURSPOS. 


2.2.3.  Presentations  CSU 

This  CSU  documents  the  funedons  that  deal  with  mouse-sensidve  presentations  that  enable 
most  of  this  editor's  functionality.  It  comprises  the  defmitions  of  presentation  types, 
actions,  and  their  associated  functions.  These  are  further  separated  into  groups 
corresponding  to  their  presentation  pane. 


Presentation  Type  WEAPON-SYSTEM: 

This  is  a  presentation  type  definition  where  the  definition  of  a  type  is  not  required. 
Otherwise  it  contains  standard  settings.  It  is  used  in  the  pane  named  MODEL-COMMAND- 
PANE  of  the  flavor  OBJECT-MS-PANE. 


Presentation  Action  SELECT-WEAPON-SYSTEM; 

This  is  a  presentation  action  of  the  WEAPON-SYSTEM  presentaticHi  type.  When  the 
mouse  is  within  a  displayed  weapon-system  presentation,  the  mouse  documentation  line  at 
the  bottom  of  the  screen  displays  the  character  string  "L:  Select  this  weapon  system". 
Clicking  the  left  mouse  button  invokes  the  action,  which  is  executed  if  a  test  is  passed. 
(The  test  checks  to  see  if  the  pane  on  which  the  click  uxdc  place  is  named  the  MODEL- 
COMMAND-PANE.)  The  action  invoked  upon  passing  the  test  is  to  send  the  messages 
:PUT-OBJECT-IN-TABLE  and  :PUT-OTHER-STUFF-BACK-TO-WHERE-THEY- 
WERE  to  the  frame. 
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Function  PRESENT- WEAPON-NAMES: 

The  purpose  of  this  function  is  to  display  the  various  weapon  system  names  as  mouse- 
sensitive  presentations  so  that  they  can  used  to  select  a  we^ns  system  to  edit 

The  procedure  for  this  function  is  to  first  locally  bind  N-COLUMNS  and  COLUMN- 
WIDTH  and  then  clear  die  window.  Next  the  we^n  system  names  in  *OBJECT- 
NAMES*  are  displayed  in  two  rows  as  presentations  of  types  WEAPON-SYSTEM.  The 
:SET-CURSORFOS  message  insures  that  the  names  are  properly  spaced  and  that  the 
second  row  is  started  before  running  out  of  qmce. 


Presentation  Type  FIELD-ELEMENT: 

This  is  a  presentaticxi  tyi»  definition  where  the  definition  of  a  TYPE  is  not  required. 
Otherwise,  the  presentation  type  uses  standard  settings.  It  is  used  in  the  panes  named 
TABLEl,  TABLE2.  and  TABLES  of  the  flavor  OBJECT-MS-PANE. 


PresentaticMi  Action  DESCRIBE-FIELD: 

This  is  a  presentation  action  of  the  FIELD-ELEMENT  presentatitMi  type.  When  the  mouse 
position  on  screen  is  within  a  displayed  field-element  presentation,  the  mouse 
documentation  line  at  the  bottom  of  the  screen  displays  the  string  retrieved  by  the  function 
GET-FIELD-DESCRIPTOR.  No  action  is  trigger^  by  clicking  the  mouse  button  while  on 
this  presentation;  the  cmly  effect  is  the  r^pearance  of  descriptive  information  in  the  mouse 
documentation  line. 


Function  GET-FIELD-DESCRIPTOR: 

The  purpose  of  this  function  is  to  retrieve  the  descriptor  string  corresponding  to  the  name 
of  the  arguimnt  passed  (FIELD-NAME),  and  to  compose  it  for  display  in  the  nxiuse 
document  line. 

The  function  calls  the  function  FIND-FIELD-DESCRIPTOR  in  order  to  retrieve  the 
descriptor  string  and  binds  the  result  to  the  local  variable  DESCRIPTOR.  If  no  descriptor  is 
found,  it  returns  the  string  "No  descriptor  in  file".  If  DESCRIPTOR  is  not  null,  it  uses  the 
truth  value  of  the  secemd  element  of  DESCRIPTOR  to  append  the  string  "(Changeable  by 
User,  yes  (no)"  to  the  actual  descriptor  string  which  is  the  third  element  of  DESCRIPTOR. 
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Function  FIND-FIELD-DESCRIPTOR: 

The  purpose  of  this  function  is  to  retrieve  the  descriptor  string  corresponding  to  the  name 
of  the  argument  passed  (FIELD-NAME)  fnxn  the  descriptors  in  *OBJECT- 
DESCRIPTIONS*. 

This  is  a  presoitation  action  of  the  UNDO-COMMAND  presentatitxi  type.  When  the  mouse 
is  within  a  display  "UhHX)"  command  presentation,  the  mouse  documentation  line  at  the 
bottom  of  the  screen  displays  the  string  "L:  Undoes  last  change".  Clicking  the  left  mouse 
button  invokes  the  action,  odling  the  function  UNDO-LAST-CHANGE. 

Presentadon  Type  NUMBER-ELEMENT: 

This  is  a  presentadon  type  definidon  where  the  TYPE  definidon  is  expanded  to  be  a 
NUMBER.  This  enables  inheritance  of  all  presentadon  acdons  of  the  NUMBER  type.  It  is 
used  in  the  panes  named  TABLEl,  TABLE2,  aixl  TABLES  of  the  flavor  OBJECT-MS- 
PANES. 


Presentadon  Acdon  REPLACE-NUMBER-ELEMENT: 

This  is  a  presentadon  acd(»i  of  the  NUMBER-ELEMENT  presentadon  type.  When  the 
mouse  is  within  a  display  number-element  presentadcm,  the  mouse  docu^ntadon  line  at 
the  bottom  of  the  screen  displays  the  string  "L:  Replace  this  number".  Clicking  the  left 
mouse  button  invokes  the  acdon,  sending  the  message  :REPLACE-NUMBER. 


Method  -.REPLACE-NUMBER  Of  The  Flavor  OBJECT-PANE: 

The  purpose  of  this  method  is  to  replace  the  numerical  value  of  a  weapons  system 
parameter  with  a  new  value  specified  by  the  user. 

The  method  first  binds  the  local  variables  NEW-NUMBER,  SUPERIOR,  and  FIELD- 
NAME.  It  then  sends  the  message  :REPLACE-1TEM  to  update  the  pane's  ITEM-LIST  and 
adds  infcMinadon  useful  to  undo  the  replacement  of  the  push  down  list  in  LIST-OF- 
CHANGES.  It  the  sets  NEW-NUMBER  to  the  value  of  :XREPLACE-OBJECT- VALUE, 
a  system  method  that  handles  types  inputs  on  numeric  presentadons. 

Presentad(Mi  Type  SAVE-COMMAND: 

This  is  a  presentadon  type  definidon  that  does  not  require  the  definidon  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  panes  TABLE  1-MENU,  TABLE2- 
MENU,  and  TABLE3-MENU  of  the  flavor  SA  VE-OBJECJT. 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


Presentation  Action  EXECUTE-SA  VE-CX)MMAND: 

This  is  a  pre^ntation  action  of  the  SAVE-CX)MMAND  presentation  type.  When  the  mouse 
is  within  a  display  number-element  presentation,  the  mouse  documentation  line  at  the 
bottom  of  the  screen  displays  the  string  "L:  Preserves  changed  data".  Clicking  the  left 
mouse  button  invt^es  the  acdm,  sending  the  message  :SAVE-OBJECT. 


Function  SAVE-OBJECT: 

The  purpose  of  this  function  is  to  save  the  newly  edited  parameter  values  of  a  weapcms 
system. 

The  procedure  is  to  send  the  message  rSAVE-ALL-OBECT-INFORMATION  to  the  pane. 

Method  rSAVE-ALL-OBJECr-INFORMATION  Of  The  Flavor  OBJECT-MS-PANE: 

The  purpose  of  this  method  is  to  save  the  set  of  parameters  of  the  given  weapons  system  in 
the  Ust  bound  to  the  global  variable  ♦WORKED-ON-OBJECT-FORMS*. 

The  procedure  is  to  first  check  if  the  instance  variable  LIST-OF-CHANGES  of  the  pane 
does  not  contain  any  changes  to  preserve.  If  this  is  the  case,  the  pane's  interaction  panel 
flashes  (beeps)  and  displays  the  string  "There  aren't  any  changes  to  preserve".  If  there  are 
changes  to  imserve,  the  local  variable  CATEGORY  is  first  bound  to  the  name  of  the 
weapons  system  under  edit  Next  in  the  event  of  changes,  the  value  of  ITEM-LIST,  the 
entire  set  of  parameter  names  and  values  of  the  weapon  system,  substitutes  for  the  old  set 
in  ♦WORKl^ON-OBJECT-FORMS*.  The  substitution  is  made  in  the  system  function 
SUBST. 

Presentation  Type  UNDO-CXJMMAND: 

This  is  a  presentation  type  definition  that  does  not  require  the  definition  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  panes  TABLE  1 -MENU,  TABLE2- 
MENU,  and  TABLE3-MENU  of  the  flavor  TABLE-COMMAND_FRAME. 


Presentation  Action  EXECUTE-UNDO-COMMAND: 

This  is  a  presentation  action  of  the  UNDO-COMMAND  presentation  type.  When  the  mouse 
is  within  a  display  "UNDO"  command  presentaticm,  the  nKxise  documentation  line  at  the 
bottom  of  the  screen  displays  the  string  "L:  Undoes  last  change".  Clicking  the  left  mouse 
button  invokes  the  action,  calling  the  function  UNDO-LAST-CHANGE. 
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Function  UNDO-LAST-CHANGE: 

The  purpose  of  this  function  is  to  undo  the  last  change  made  to  a  weapcm  system  parameter 
value. 

The  fiinctitm  binds  the  arguments  needed  by  UNDO-LAST-CHANGE-INTERNAL ,  a  call 
to  which  does  the  work. 

Method  :UNDO-LAST-CHANGE-INTERNAL  Of  The  Flavor  OBJECT-MS-PANE: 

The  purpose  of  this  method  is  to  undo  the  last  change  made  to  a  weapons  system  parameta* 
value. 

The  method  first  binds  the  local  variable  ITEM-CHANGED  to  die  old  value  of  the 
parameter  last  changed  by  calling  the  function  POP-CHANGE-LIST.  It  next  binds  the  local 
variable  CATEGORY  to  the  name  of  the  weapon  system  bdng  edited  by  searching  through 
the  contents  of  *OBJECr-TO-WINDOW-ASSOC,  which  is  a  list  of  pairs  of  the  form 
pane-name  weapon-system-name.  Then,  if  there  is  no  ITEM-CHANGED  it  beeps  the 
interaction  pane.  Otherwise,  it  replaces  die  new  value  given  in  the  parameter  with  the  old 
one  and  re^splays  the  pane. 

PresentaticMi  Action  EXECUTE-UNDO- ALL-COMMAND: 

This  is  a  presentation  action  of  the  UNDO-COMMAND  presentation  type.  When  the  mouse 
is  within  a  display  "UNDO"  command  presentaticMi,  the  mouse  documentation  line  at  the 
bottom  of  the  screen  displays  the  string  "L:  Undoes  last  change".  Clicking  the  left  mouse 
button  invokes  the  action,  calling  the  function  UNDO-LAST-CHANGE. 


Function  UNIX)- ALL-CHANGES: 

The  purpose  of  this  function  is  to  undo  all  changes  made  to  a  weapons  system  parameter 
values  since  it  was  last  saved. 

The  functitxi  first  binds  the  local  variables  PANE-NAME,  PANE,  CATEGORY-NAME, 
OLD-DATA,  and  NEW-DATA.  It  then  sets  CATEGORY-NAME  to  the  name  of  the 
weapon  system  being  edited.  OLD-DATA  is  set  to  the  old  values  of  the  weapon  system 
parameters,  extracted  from  the  value  of  the  global  variable  *OBJECT-FORMS*.  ifeW- 
DATA  is  set  to  the  current  (edited)  values  of  the  weapon  system  parameters,  extracted  from 
the  global  variable  ♦WORKED-ON-OBJECTT-FORMS*.  Then  the  old  values  are  made  to 
substitute  for  the  new  values  and  the  pane  is  sent  the  :REVERT-PANE  message. 
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Presentation  Type  CLOSE-CX)MMAND; 

This  is  a  presentation  type  definition  that  does  not  require  the  definition  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  panes  TABLEl-MENU,  TABLE2- 
MENU,  and  TABLE3-MENU  of  the  flavor  TABLE-COMMAND-PANE. 


Presentation  Action  EXECUTE-CLOSE-COMMAND: 

This  is  a  presentation  action  of  the  CLOSE-COMMAND  presentation  type.  When  the 
mouse  is  within  a  display  "Close"  command  presentation,  the  mouse  documentation  line  at 
the  bottom  of  the  screen  displays  the  string  "L:  Get  rid  of  this  pane.  Changes  will  be  lost 
unless  SAVEd".  Clicldng  the  left  mouse  button  invokes  the  action,  calling  the  function 
CLOSE-OBJECT-PANE. 


Function  CLOSE-OBJECT-PANE: 

The  purpose  of  this  function  is  to  close  the  pane  where  the  weapon  system  is  displayed. 
The  fTBimt  readjusts  to  display  the  remaining  open  panes. 

The  functioi  first  binds  the  local  variables  PANE-NAME  and  PANE.  It  then  nulls  the 
instance  variable  ITEM-LIST,  calls  DELETE-TABLE-OBJECT-ASSOCIATION,  and 
readjusts  the  frame  by  calling  rREPUT-STUFF-BACK-INTO-EDrrOR-IN-A- 
DIFFERENT-PLACE-IF-NECESSARY. 

Function  PRESENT-PANE-COMMANDS: 

The  purpose  of  this  function  is  to  make  and  display  mouse-sensitive  presentati(»is  which 
when  activated  can  issue  editor  commands  for  saving,  undoing,  and  closing. 

This  function  binds  the  local  variable  COMMAND-PANES  to  the  list  of  command  panes  in 
the  frame  and  then  calls  PRESENT-PANE-COMMANDS- 1  on  each  of  them  to  do  the 
work. 

Function  PRESENT-PANE-COMMANDS- 1: 

The  purpose  of  this  function  is  to  make  and  display  mouse-sensitive  presentations  for  the 
editor  commands  for  "Save",  "Undo",  Undo  AH",  and  "Close". 

The  function  first  clears  the  pane.  It  then  uses  the  system  function  PRESENT  to  display  the 
appropriate  mouse- sensitive  presentation.  The  four  commands,  listed  above,  are  evenly 
spread  in  the  central  80%  of  the  pane's  width  with  the  help  of  the  system  method  :SET- 
CURSORPOS. 
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Presentaticm  Type  WRITE-COMMAND: 

This  is  a  presentation  type  definition  that  does  not  require  the  definition  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  pane  COMMAND-PANE  of  the  flavor 
OBJECT-GLOBAL-COMMAND-PANE. 


Presentaticm  Action  EXECUTE- WRITE-COMMAND: 

This  is  a  presentation  action  of  the  WRITE-COMMAND  presentaticm  type.  When  the 
mouse  is  within  a  display  'Write"  command  presentaticm,  the  mouse  documentaticm  line  at 
the  bottom  of  die  sc:reen  displays  the  string  "L:  Store  all  clata  in  SIMHOST  file".  Clicking 
the  left  mouse  button  invc^es  Ae  action,  calling  the  function  WRITE-OBJECT-FILE. 


Presentaticm  Type  REVERT-COMMAND: 

This  is  a  presentation  type  definition  that  does  not  require  the  definition  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  pane  COMMAND-PANE  of  the  flavor 
OBJECT-GLOBADCOMMAND-PANE. 


Presentation  Action  EXECUIE-REVERT-COMMAND: 

This  is  a  presentation  action  of  the  REVERT-COMMAND  presentation  type.  When  the 
mouse  is  within  a  display  "Revert"  command  presentation,  the  mouse  dcmumentation  line  at 
the  bottom  of  the  screen  displays  the  string  "L:  Reads  the  original  FACTORY  version  of 
the  SIMHOST  file".  Clicking  die  left  mouse  button  invokes  die  action,  calling  the  function 
REVERT-TO-FACTORY-FILE. 


Function  REVERT-TO-FACTORY-FILE: 

The  purpose  of  this  function  is  to  read  and  display  weapons  system  parameters  stored  in 
the  original  factory  version  of  the  CONFIG  LISP  file.  This  provides  a  way  to  revert  to  the 
factory  set  parameters  for  all  weapons. 

The  function  calls  the  function  READ-OBJECT-FILE  with  a  path  segment  pointing  to  the 
factory  file,  and  initializes  the  editor. 


Presentaticm  Type  RESET-COMMAND: 

This  is  a  presentation  type  definition  that  does  not  require  the  definition  of  a  TYPE.  It 
otherwise  uses  standard  settings.  It  is  used  in  the  pane  COMMAND-PANE  of  the  flavor 
OBJECT-GLOBAUCOMMAND-PANE. 
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Presentation  Action  EXECUTE-RESET-CDMMAND: 

This  is  a  pr^ntation  actitxi  of  the  RESET-CX)MMAND  presentaticm  type.  When  the 
mouse  is  within  a  display  "Reset"  command  presentaticm,  the  mouse  documentation  line  at 
the  bottom  of  the  screen  displays  the  string  "L:  Qean  slate  and  start  over  by  re-reading 
SIMHOST  nie".  Clicking  the  left  trwuse  buttcm  invokes  the  action,  calling  the  function 
RESET-OBJECT-MENU. 


Functicm  RESET-OBJECT-MENU: 

The  purpose  of  this  function  is  to  create  a  new  editor  frame. 

This  function  initializes  the  editor  by  nulling  the  global  variables  '*‘WORKEE>-ON- 
OBJECT-FORMS*.  ♦OBJECT-FORMS*,  and  *OBJECT-FRAME*.  Then  it  calls  the 
funcdon  SELECT-OBJECT-EDITOR  and  sends  a  :KILL  message  to  the  frame  (obtained 
by  sending  WINDOW  the :  SUPERIOR  message). 


Function  SELECT-OBJECT-EDITOR: 

The  purpose  of  this  function  is  to  select  a  screen  with  the  weapons  systems  edittm  if  one 
exists,  and  to  create  one  if  no  screen  exists. 

This  function  determines  if  a  frame  exists  by  determining  that  the  global  variable 
♦OBJECT-FRAME*  is  not  null.  It  then  checks  to  see  that  the  frame  is  active  and  that  there 
are  panes  in  it.  If  that  is  the  case,  it  seleas  the  first  pane,  TABLEl .  Otherwise,  it  creates  a 
screen  with  the  system  function  TV: :RUN-SELECT-KEY-FORM.  In  either  case,  it  waits 
until  the  frame  or  pane  is  exposed  before  returning  to  caller. 


2.2.4  Auxiliaries  CSU 

This  CSU  contains  the  utility  code  for  this  editor.  These  consist  of  predicates,  macros,  in¬ 
flavor  functions,  and  methods  of  general  use. 

Function  TABLE-MENU?: 

The  purpose  of  this  function  is  to  predicate  to  test  if  the  given  pane  could  be  displaying  a 
weapons  system's  parameter. 

The  procedure  for  this  function  is  to  check  for  the  presence  of  the  substring  "lisp"  or 
"menu"  in  the  pane's  name. 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSC3 


Defsubst-in-flavor  GARCON-GET-ME-A-TABLE  Of  TTie  Ravor  DW::PROGRAM- 
FRAME: 

The  purpose  of  this  defsubst  is  to  either  find  the  pane  displaying  the  weapon  system's 
name  given  in  the  argument,  or  to  come  up  with  the  first  available  empty  one. 

The  defsubst  accomplishes  this  search  using  the  pane  to  weapon  system  association  list 
kept  in  the  global  variable  ♦OBJECT-TO-WINDOW-ASSOC*. 

Defun-in-flavor  BOOKEEPING-OF-PUTTING-OBJECT-INTO-NEW-WINDOW  Of  The 
Flavor  DW::PROGRAM-FRAME: 

The  purpose  of  this  function  is  to  assign  a  pane  to  a  new  weapon  system  to  be  edited  and  to 
update  the  association  list  that  tracks  ^e  correspondence  between  panes  and  weapon 
systems. 

The  procedure  to  accomplish  this  is  to  bind  the  local  variable  FIRST-Wr.'JDOW-FREE  to 
the  value  returned  by  the  call  to  GARCON-GET-ME-A-TABLE. 


Function  TRUNCATE-IF-NECESSARY: 

The  purpose  of  this  function  is  to  truncate  excessively  long  parameter  names  or 
alphanumeric  values  so  that  the  pane  width  is  not  exceeded. 

The  procedure  that  this  function  uses  is  for  the  STRING  passed  as  a  argument  to  be  trimed 
to  LENGTH  characters,  if  the  STRING  is  longer.  The  characters  "..."  are  substituted  for 
last  three  characters  in  the  STRING  if  this  is  the  case.  LENGTH  may  either  be  a  second 
argument  passed  or,  if  no  argument  is  passed,  18  characters. 

Method  :STUFF-OBJECT-INTaPANE  Of  The  Ravor  DW::PROGRAM-FRAME: 

The  purpose  of  this  method  is  to  display  a  weapon  system's  parameters  in  a  pane. 

The  procedure  used  is  a  straightforward  association. 


Inline  Function  COUNT-WINDOWS-USED; 

The  purpose  of  this  function  is  to  count  the  number  of  weaptm  system  panes  in  use. 

The  procedure  to  accomplish  this  inline  function  is  a  count  loop  using  the  association  list 
bound  to  the  global  variable  ♦OBJECT-TO-WINDOW-ASSOC*. 
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Inline  Function  TRANSLATE-CONHG-TO-NUM-TABLES-USED; 

The  purpose  of  this  function  is  to  come  up  with  the  number  of  panes  into  which  a  given 
fiame  configuration  can  Et 

The  procedure  used  is  a  straightforward  association. 

Inline  Function  GET-TABLE-POSmON-IN-LIST: 

The  purpose  of  this  function  is  to  come  up  with  an  ordinal  number  for  the  given  pane. 
The  procedure  used  is  a  straightforward  association. 


Inline  Function  UP-OR-LOWER-CONFIGURATION-IF-NECESS ARY  In  The  Flavor 
DW::PROGRAM-FRAME: 

The  purpose  of  this  function  is  to  change  up  or  down  the  number  of  panes  in  the  frame,  if 
necessary. 

The  procedure  that  this  inline  function  uses  is  to  first  bind  the  local  variable  NUMBERS - 
US^  to  the  number  of  the  pane  being  currently  used  and  to  bind  the  local  variable 
NUMBERS-AVAILABLE  to  the  number  of  panes  that  can  be  accommodated  in  the  current 
firame  configuration.  Then  it  resets  the  fiame  configuration  accordingly,  increasing  or 
decreasing  ^e  number  of  panes  as  needed. 

Method  :PUT-OBJECT-IN-TABLE  Of  The  Flavor  DW::PROGRAM-FRAME: 

The  purpose  of  this  method  is  to  set  up  the  frame  configuration  and  to  display  a  weapon 
system's  parameters. 

The  procedure  is  to  call  UP-OR-LOWER-CONHGURATION-IF-NECESSARY  and 
:PUT-OBJECT-IN-TABLEl  to  do  the  work. 

Method  :PUT-OBJECT-IN-TABLE-l  Of  TheHavorDW;:PROGRAM-FRAME: 

The  purpose  of  this  method  is  to  display  a  weapon  system's  parameters  for  the  first  time. 

The  procedure  of  this  method  is  to  first  bind  the  local  variables  TABLE  and  TABLE- 
OBJECT  to  a  pane  obtained  via  a  call  to  :BOOKKEEPING-OF-PU  l’llNG-OBJECT- 
INTO-NEW- WINDOW.  It  then  clears  the  pane  and  calls  :STUFF-OBJECT-INTO-PANE 
to  fill  it. 
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Method  :PUT-OTHER-STUFF-BACK-TO-WHERE-THEY-WERE  Of  The  Flavor 
DW::PR(X5RAM  FRAME: 

The  purpose  of  this  method  is  to  redisplay  weapon  systems  parameters  after  a  configuration 
change. 

The  procedure  of  this  method  is  to  check  the  list  of  pairs  (weaptxi  system  name,  pane)  in 
the  global  variable  ♦OBJECT-TO-WINDOW-ASSOC*  to  cither  send  the  :REDISPLAY- 
PANE  message  or  the  :STUFF-OBJECT-INTOPANE  message,  as  required. 


2.2.5  Program  Frame  CSU 

This  CSU  defines  the  frame  object  that  underlies  the  Vehicle  and  Weapon  System 
Parameter  Editor.  It  consists  of  the  definition  of  the  panes  and  of  the  omfigiuations 
(arrangement  of  panes)  of  the  frame,  as  well  as  some  top-level  methods  and  functions. 


Program-Framework  OBJECT-MENU: 

This  defines  the  kinds  of  panes  and  configurations  that  the  Weapons  Systems  Editor  uses. 

The  Weapons  Systems  Editor  uses  six  kinds  of  panes:  LOGO-PANE,  MODEL- 
COMMAND-PANE,  COMMAND-PANE,  TABLE  pane  type,  TABLE-MENU  pane  type, 
and  LISP-PANE. 

The  LOGO-PANE  displays  the  "WeaptHis  System  Editor"  identifier  at  the  top  of  the 
screen.  It  is  of  a  type  built  into  the  system  that  is  specified  by  the  keyword  :TmJE. 
It  is  displayed  in  reverse  video. 

The  MODEL-COMMAND-PANE  displays  the  names  of  all  the  weapon  systems  as 
mouse-sensitive  presentations.  Its  type  is  specified  by  the  flavor  OBJECT-MS - 
PANE. 

The  COMMAND-PANE  displays  the  three  presentations  fw  the  commands 
"Write",  "Reset",  and  "Revert".  Its  type  is  specified  by  the  flavor  OBJECTT- 
GLOBAL-COMMAND-PANE. 

The  member  of  the  TABLE  pane  type  (TABLE  1,  TABLE2,  and  TABLES)  display 
weapon  system  parameter  sets  in  columns  of  nameAalue  pairs.  Their  type  is 
specified  by  the  flavor  OBJECT-MS-PANE. 
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The  members  of  the  TABLE-MENU  pane  type  (TABLE  1 -MENU,  TABLE2- 
MENU,  and  TABLE3-MENU)  fit  underneath  their  corresptMiding  TABLE  panes. 
They  contain  the  four  presentations  fw  tite  command  "aose",  "Undo",  "Undo 
All",  and  "Save"  commands.  Their  type  is  specified  in  the  flavor  TABLE- 
COMMAND-PANE. 

The  LISP-PANE  is  the  interaction  pane  of  pre-defined  type  LISTENER. 

The  Weapons  Systems  Editor  frame  uses  three  configuiaticms,  to  accommodate  as  many  as 
three  weaprm  system  parameter  sets  on  the  screen.  The  three  configurations  are  named 
MAIN  (for  the  minimum  of  one  parameter  set),  MAIN-WnH-2  (for  two  sets),  and  MAIN- 
WTH-3  (for  three  sets).  Each  configuration  specification  consists  of  a  layout  specifrcation, 
where  panes  are  given  in  top-to-bottom  and  left-to-right  order,  and  a  size  specificaticm, 
given  in  screen  percentages  or  in  number  of  lines.  The  following  table  shows  the  panes 
contained  in  each  frame  craifrguration. 


^'^^^^Ot^lGURATION 

PANE 

MAIN 

MAIN+2 

MAIN-f3 

LOGaPANE 

• 

• 

• 

MODEL-COMMAND-PANE 

• 

• 

• 

COMMAND-PANE 

• 

• 

• 

TABLE1 

• 

• 

• 

TABLE2 

• 

• 

TABLES 

• 

TABLE1-MENU 

• 

• 

• 

TABLE2-MENU 

• 

• 

TABLE3-MENU 

• 

LISP-PANE 

• 

• 

• 

#  Indicates  Configuration  Contains  This  Pane 


Table  2.2.5- 1  Panes  Contained  in  Each  Frame  Lbnfiguration 


Method  :TOP-LEVEL  Of  The  Flavor  OBJECT-MENU: 

The  purpose  of  this  method  is  to  perform  initialization.  The  procedure  involved  is  to  set  a 
number  of  global  variables,  read  in  data  via  a  call  to  READ-OBJECT-FILE ,  display  initial 
presentation,  and  launch  the  Lisp  listener  that  handles  user  inputs. 
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Method  :SET-TO-LOWER-CONHGURATION  Of  The  Flavor  DW::PROGRAM-FRAME: 

The  purpose  of  this  method  is  to  decrease  the  number  of  weapons  systems  shown  on  the 
screen.  The  procedure  involved  is  to  send  itself  the  :CX>NFIGlJRATION  message  to 
determine  the  current  configuration,  and  then  to  choose  the  one  with  less  table  pane  in 
it. 

Method  :SET-TafflGHER-CONnGURATION  Of  The  Havor  DW::PROGRAM- 
FRAME: 

The  purpose  of  this  method  is  to  increase  the  number  of  weapons  systems  shown  on  the 
screen.  The  procedure  involved  is  to  send  itself  the  rCONFIGURATlON  message  to 
determine  the  current  oxifiguration,  and  then  to  choose  the  (me  with  one  less  table  pane  in 
it. 


2.3  FORMATIONS  EDITOR  CSC 

The  FORMATIONS  EDITOR  allows  users  to  edit  the  positions  (x,  y  and  z  c(x>rdinates)  of 
each  of  the  elements  that  configure  a  military  unit.  For  example,  a  NATO  tank  platoon  in 
Line  formation  has  its  tanks  90  meters  apart,  on  a  straight  line,  heading  90°  from  the  line. 
With  the  help  of  the  editor,  a  user  can  alter  any  frxmation  in  a  natural  visual-oriented 
manner. 

The  resulting  formation  changes  can  then  be  evaluated  for  their  tactical  effects. 

The  software  for  this  editcm  can  be  found  in  the  file  saf>interface>formations.lisp. 

This  CSC  edits  the  Simhost  files  saf/config/blue_forms.Iisp  and  saf/config/red_fomis.lisp. 

The  formations  editor  consists  of  the  following  CSlTs: 

Parameters  and  Globals 
File  Input/Output 
Formati(xis  object 
Panes  and  Frame 
Presentations  and  commands 
Drawing  Routines 

A  description  of  each  of  these  units  follows.  Each  unit  is  legated  in  the  file  following  a 
comment  header,  an  abbreviated  form  of  this  header  is  included  below,  in  brackets,  at  the 
beginning  of  each  section. 
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2.3.1  Parameters  and  Giobals  CSU 
[ ; ; ;  PARAMETERS  and  other  GLOB ALS  ] 

This  is  just  a  list  of  variable  definitions  used  globally  (mostly  within  the  Formations  editor 
code).  Hieir  names  are  enclosed  in  asterisks  (*),  their  initial  values  are  specified,  and  most 
have  their  purpose  explained  by  a  brief  documentation  string. 


2.3.2  File  Input/Output  CSU 
[ ; ; ;  FILE  I/O  FUNCTIONS  ] 

This  unit  contains  two  functions  that  read  the  SIMHOST  files  into  tiie  Editor,  and  write  it 
back  (»ito  the  SIMHOST  when  the  editing  is  finished.  The  entire  SIMHOST  file  is  read  as 
a  list  which  is  the  value  of  *CONFIGURATlON-FORMS*.  For  all  practical  piuposes  this 
variable  represents  the  entire  Formations  database. 


2.3.3  Formations  object  CSU 
[ ; ; ;  FORMATIONS  ] 

This  unit  ccmtains  the  code  that  defines  FORMATION-OBJECn'  (the  data-structures  the 
editor  deals  with,  representing  each  vehicle  within  a  formation).  FORMATION-OBJECH' 
has  Instance-Variables  (fields)  representing  relative  position,  the  name  of  the  formation  it 
belongs  to,  the  kind  of  vehicle  it  is,  and  what  kind  of  unit  it  is  a  part  of. 

The  unit  also  contains  the  Methods  (accessor  functions)  for  reading  and  writing  the  values 
of  these  fields. 

The  position  Instance-Variables  (x,  y,  and  z)  are  location  pointers  into  the  database  (i.e.: 
the  value  of  *CONFIGURATION-FORMS*),  GET  and  SET  methods  perform  the 
required  pointer  setting  so  that  any  changes  to  the  position  variables  of  a  FORMATION- 
OBJECT  instance  will  be  reflected  in  the  database. 

The  function  CREATE-FORMATION-OBJECTS  uses  the  database  as  a  pattern  to  make 
instances  of  FORMATION-OBJECTs,  while  GATHER-FORMATION-OBJECTS  rounds 
up  those  belonging  to  any  echelon,  vehicle-type  or  formation  (e.g.:  all  FORMATION- 
OBJELTs  that  are  Tanks,  belong  to  a  Platoon,  and  are  in  Line  formation) 
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2.3.4  Panes  and  Frame  CSU 
[;;;PANES  and  FRAME] 

This  CSU  contains  the  code  that  defines  the  Editor  I^ame,  as  well  as  the  individual  panes 
that  appear  within  it,  as  seen  tm  the  screen. 

Each  pane  is  defined  via  a  flavor  definition.  lAFTER  *£XPOSE  methods  are  responsible 
for  presenting  the  command  labels  (Grid,  Zoom,  Write,  etc)  that  will  be  activate  when 
clicked  by  the  user. 

The  choice  pane  near  the  bottom  of  the  screen  is  serviced  by  the  :UPDATE-CHOIC£S 
method,  wiA  the  help  of  the  functitms  GET- VEHICLE-CHOICES  and  GET- 
FORMATION-CHOKTES..  Together  they  constitute  the  machinery  for  selecting  the  desired 
formation  by  clicking  on  any  one  of  the  ^helon.  Vehicle  type.  Formation,  or  Tactics 
choices. 

Finally,  the  frame  itself  is  defined  as  a  program  framework  with  two  configurations: 

MAIN,  which  provides  an  XY  plan  view  used  for  ground  vehicles,  and  MAIN-FOR- 
ALTFIUDE-DISPLAY,  which  adds  a  YZ  vertical  view  for  air  units. 


2.3.5  Presentations  and  commands  CSU 
[ ; ; ;  PRESENTATIONS  ] 

This  unit  ccmtains  code  (i.c.:  DEFINE-PRESENTATION-TYPE)  to  define  the  mouse 
sensitive  presentations  (ctHumand  buttons,  vehicle  icons,  coOTdijnate  values)  Uiat  users  will 
activate  to  effect  the  changes  they  want  It  also  contains  c^e  to  inclement  the  functionality 
associated  with  the  presentations  (DEFINE-PRESENTATION-ACjnON  and  associated 
functions  and  methods) 

The  software  is  grouped  by  commands,  as  they  appear  in  the  editor  frame  (e.g.:  Grid, 
Zoom,  etc).  Within  groups,  presentation-types  go  first,  followed  by  presentation-actions 
and  their  associated  code. 


2.3.6  Drawing  Routines  CSU 
[ ; ; ;  Code  for  drawing  foimaticHi  vehicles  ] 

This  unit  contains  code  for  drawing  tank,  helicopter,  and  aircraft  icons  on  the  screen,  and 
code  fw  drawing  the  distance  grids  on  the  display  panes.  Many  constants  governing  the 
appearence  of  these  images  are  coded  right  into  the  forms,  ratl^  than  stor^  in  naii^ 
symbols. 
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A.l  Introduction 
A.1.1  Overview 

Semi-Automated  Forces  (SAF)  rans  on  two  different  kinds  of  computers:  workstation 
computers  and  simulation  (simhost)  computers.  The  SAF  workstations  allow  a  user  (the 
SAF  commander)  to  interact  with  t^  SAF  system  by  way  of  an  extensive  list  of  acticMis 
and  options  fw  mcmittHing  and  controlling  ^  SAF  units  under  his  command.  The  simhost 
computers  are  in  charge  of  simulating  the  motion  arxl  activities  of  the  SAF  vehicles.  They 
are  responsible  for  making  SAF  vehicles  behave  reasonably  (e.g.,  tanks  stay  on  the 
ground,  avoid  obstacles,  deplete  supplies,  and  much  more)  and  fa  generating  up-to-date 
packets  of  data  to  represent  the  state  (terrain  posititm,  motion,  firing,  turret  motion,  and  so 
on)  of  each  and  all  of  the  active  SAF  vehicles. 

The  SAF  (I!ommand  Protocol  provides  a  communications  framework  between  the 
Symbolics  w^kstation  and  the  Mips  simhost.  SAF  uses  the  User  Datagram  Protocol 
(UDP),  which  does  not  guarantee  (^ered  reception  of  individual  data  packets,  to  build  a 
Reliable  User  Datagram  Protocol  (RUDP),  which  does  guarantee  orde^  reception  of 
individual  data  packets.  Within  this  framewcxk,  the  workstation  and  simhost  are  able  to 
send  messages  to  each  other. 

This  document  describes  the  layout  of  the  messages  passed  between  the  workstation  and 
the  simhost.  The  messages  that  are  passed  between  the  w^kstation  and  simhost  are 
described  in  the  following  source  files:  /sitnnetAnclude/sa£(src/message.h  on  the  simhost 
and  >saf>network>packet-layouts.lisp  on  the  workstation.  Messages  described  in  the 
source  tiles  but  not  identified  in  this  document  are  not  used  in  SAF  version  3.9. 10. 


A.1.2  Data  Types 

The  following  data  types  are  used  in  the  descriptions  of  the  SAF  C^cmunand  Protocol  data: 

char  -  8  bits,  1-byte  capable  of  holding  one  character 

short  - 16  bits,  2-bytes  capable  of  holding  one  integer 

int  -  32  bits,  4-bytes  capable  of  holding  one  integer 

float  -  32  bits,  4-bytes  cqrable  of  holding  erne  single-precision  floating  point 
number 


double  -  64  bits,  8-bytes  capable  of  holding  one  double-precision  floating  point 
number 
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When  a  data  type  is  described  as  unsigned,  the  leftmost  bit  will  not  contain  a  sign.  When 
an  array  is  described,  the  number  of  elements  of  die  specified  type  will  be  enclosed  in 
brackets  following  the  item  name.  For  example,  die  descriptitxi,  "char  fQrmation[36]", 
means  that  dK  item,  formation,  is  an  array  of  36  elements  and  each  element  is  a  1-byte 
character. 

A.1.3  Data  Elements  of  a  SAP  Packet 

The  packets  diat  are  passed  between  the  workstation  and  simhost  are  made  up  of  two 
components;  a  header  plus  message  data.  Every  packet  has  a  header  that  can  identify  a  unit 
(or  vehicle)  and  a  message  type.  Most  packets  contain  message  data  that  is  specific  to  the 
message  t)^.  A  few  types  of  packets  do  not  require  any  message  data. 


A.1.3.1  Header  Data 


Description;  The  header  contains  two  fields,  an  identifier  and  a  message  type.  The 
identifier  contains  relevant  vehicle  or  unit  identifier  data.  Usually  this  identitier  specifies 
the  unit  or  vehicle  that  the  message  tqiplies  to. 


Simhost  ID;  hdr 


Workstation  ID;  opfor-header 


Content; 

ITEM  TYPE 

id  unsigned  short 

id  unsigned  short 


COMMENT 

unit  or  vehicle  ID 
message  type 


A.1.3.2  Message  Data 

See  the  next  two  chapters  for  descriptions  of  message  data. 
A.2  Workstation  to  Simhost  Message  Descriptions 


A.2.1 


Set-Up  Messages 


A.2.1.1  Create  Message 


E)escription:  The  create  message  is  sent  each  time  the  user  creates  a  force  via  the  Create 
Unit  ccxnmand  on  the  batdemaster  screen.  When  an  exercise  is  restored  via  the  Restore 
Exercise  ctxnmand  (xi  the  battlemaster  screen,  a  create  message  is  automatically  generated 
and  sent  fcx*  each  created  force  that  was  saved  in  the  exercise  file.  The  create  message 
causes  a  unit  and  all  of  its  inferior  units  and  vehicles  to  be  instantiated  by  the  simhosL 
See  "The  SIMNET  Network  and  Protocols",  BBN  report  number  7102,  July  31,1989  or 
the  files  mentioned  in  the  field  descriptions  below  for  additional  information. 


Message  Type:  1 

Simhost  ID:  OPFOR_MSG_CREATE 


Woikstaticm  ID:  create-request 

Content: 


ITEM  TYPE 


COMMENT 


fcxoelD 

countiyD 

countt^ 

tactics 

echelon 


unsigned  char 
unsigned  char 
nsigned  char 
unsigned  char 
unsigned  char 


echelon_type 

sbx_uniq_id 


unsigned  char 
unsigned  char 


padding 

unsigned  char 

fbrmation[36] 

char 

heading 

double 

position[3] 

double 

battalion 

unsigned  short 

crxnpany 

unsigned  char 

platocMi 

unsigned  char 

percent_ammo 

unsigned  char 

percent_fuel 

float 

belongs  to  US  or  USSR  force 

country  distinguished  vehicle  guise 

country  other  vehicle  guise 

Warsaw  Pact  or  NATO  tactics 

code  value  from  the  mappings.lisp  file.  For 

exan^le,  company,  platoon,  vehicle  etc. 

code  value  from  the  mappings.lisp  file.  For 

example,  tank,  mech,  etc. 

a  unique  Sym1x>lics-generated  sequence  number. 

Each  time  the  user  pl^es  a  force  via  the  Select  Unit 

command  on  the  battlemaster  screen,  the  sequence 

number  is  incremented  by  1.  The  sequence  number 

is  reset  to  0  whenever  the  workstation  code  is 

booted. 

one  of  the  valid  fcxmation  names.  See 
red_forms.lisp  and  blue_forms.lisp 
heading  in  mils 
x,y,z  coordinates 

battalion  number  of  this  workstation 
ccxnpany  assigiunent 
platotxi  assignment 

this  percent  applies  to  each  type  of  ammuniticm 
carried 

percent  of  fuel  on  board 


A.2.1.2  Reset  Message 


Description:  The  reset  message  is  sent  each  time  the  user  deletes  his  forces  via  the  Clear 
Units  command  or  via  the  Clear  Units  and  Overlays  command.  Both  of  these  commands 
appear  on  the  Command  Menu  on  the  color  screen.  Additionally,  there  is  a  'Clear*  type  in 
command.  In  SAP  version  3.9.10,  global,  not  selective,  reset  is  performed.  The  reset  is 
the  only  message  that  travels  in  tx^  directions.  A  reset  frcan  the  workstation  instmcts  the 
simhost  to  delete  the  indicated  vehicles  and  to  return  the  reset  message  as  amrinnation. 

Message  Type:  2 

Simhost  ID:  OPFOR_MSG_RESET 

Workstation  ID:  reset-request 

Content: 

nm  IlEE  COMMENT 

flags  int  when  set  at  0x0001 ,  the  message  means  reset  all 

vehicles 

unit_count  int  count  of  relevant  elements  in  the  unit_list  array, 

unused 

unit_list[32]  unsigned  int  delete  these  units  or  vehicles,  unused 


A.2.1.3  Vehicle  Reinitialize  Message 

Description:  When  an  exercise  is  restcxed  via  the  Restwe  Exercise  command  on  the 
battlemaster  screen,a  vehicle  reinitialize  message  is  autonuticaUy  generated  and  sent  for 
each  vehicle  that  was  saved  in  the  exercise  file.  The  vehicle  reinitialize  message  restores  a 
vehicle  to  its  state  at  the  time  the  user  saved  the  exercise  with  the  Save  Exercise  button  on 
the  commander  screen. 

Message  Type:  5 

Simhost  ID:  OPFOR_MSG_VEHICLE_REINlT 

vehicle-reinit-request 


WOTlcstation  ID: 


Content: 


ITEM 

TYPE 

COMMENT 

loads[4] 

short 

quantity  of  each  type  of  ammo 

fuel 

int 

quantity  of  fuel 

status 

char 

mobility  kill,  catastrc^hic  kill,  firepower  kill,  dug- 
in.  Sec  vehicle.c. 

padding[3] 

char 

X 

float 

reinitialize  vehicle  at  this  x-coordinate 

y 

float 

reinitialize  vehicle  at  this  y-cooidinate 

bearing 

float 

reinitialize  vehicle  with  tlm  heading 

A.2.1.4  Disconnect  Message 


Description:  Sent  when  the  user  selects  the  Connected  To  command  in  the  battlemaster 
screen.  This  command  closes  the  connection  between  the  Symbolics  and  the  Mips. 


Message  Type: 
Simhost  ID: 
Workstation  ID: 
Content: 


17 

OPFOR_MESSAGE_DISCONNECT 

disconnect-request 

0  bytes;  only  a  header  element  is  needed. 


A.2.1.5  Attach  Stealth  Message 

Description:  Sent  when  the  user  selects  the  Out-the-Window  View  command  from  the 
Display  Menu.  This  message  sets  the  site  and  host  number  of  stealth  to  enable  the  out-the- 
window-view  option. 


Message  Type: 

39 

Simhost  ID: 

OPFOR_MSG_ATTACH_STEALTH 

Workstation  ID: 

attach-stealth-request 

CcMitent: 

ITEM 

TYPE 

COMMENT 

site 

short 

site  number  of  the  stealth 

host 

short 

host  number  of  the  stealth 

A.2.2  Ask  for  Data  Messages 
A.2.2.1  Poll  Message 

Description:  This  message  polls  the  simhost  for  data.  The  polling  time  is  set  at  fifteen 
seconds  by  default,  but  can  be  changed  by  the  operator  through  the  "robo  cop  control" 
command. 

Message  Type:  14 

Simhost  ID  OPFOR_MSG_POLL 

WcHkstation  ID:  poll-request 

Content: 

nm  T£m  comment 

request  int  There  are  three  types  of  request: 

GODS  EYE  VIEW  =  0,  means  send  all  data 
NON  GODS  EYE  VIEW  =  1,  means  send  only 
data  that  the  unit  named  in  he^er  knows  about 
COMMANDER’S  EYE  VIEW  =  2,  means  send 
everything  my  troops  can  see 


A.2.2.2  Query  Sub  State  Message 

Description:  The  query  sub  state  message  is  sent  each  time  the  user  asks  for  status  data 
via  the  Status  button  on  die  commander  screen  or  via  the  Information  About  command  on 
the  Display  Menu.  This  message  asks  the  simhost  for  data  about  the  vehicle  or  unit 
(composite)  named  in  the  header.  The  simhost  will  both  compose  and  format  the  message 
and  then  send  it  back  via  the  generic  message. 

Message  Type:  18 

Simhost  ID:  OPFOR_MESSAGE_QUERY_SUB_STATE 

0  bytes;  only  a  header  element  is  needed. 


Content: 


A.2.3  IVIS  Messages 

A.2.3.1  IVIS  Xmit  Transmit  Message 


Description:  The  IVIS  Xmit  Transmit  message  is  sent  when  the  user  changes  reporting 
requirements  via  the  Set  Reporting  Requirements  command  on  the  Display  Menu.  This 
message  indicates  which  IVIS  packets  are  transmitted  to  the  SIMNET  network  and  which 
IVIS  reports  are  sent  to  the  Symbolics  wOTkstation. 

Message  Type:  19 

SimhostID:  OPFOR_MSG_IVIS_XMIT_MODES 

Workstation  ID  ivis-control-request 

Content: 


ITEM  TYPE 


COMMENT 


xmit_simnet_p  int 


xmit_sbx_p  int 


ctmtains  a  code  to  indicate  which  reports  to  send  to 
the  SIMNET  network.  The  five  transmit  codes  are: 
SENDALL  =  -1 
SENDNONE  =  0 
SENDCONTACT=  1 
SENDSPOT  =  2 
SENDSHELL  =  4 

one  of  the  transmit  codes  as  shown  above  to 
indicate  which  reports  are  sent  to  the  Symbolics 
workstation. 


A.2.3.2  IVIS  Parameters  Message 

Description:  This  message  is  sent  when  the  operator  sets  the  IVIS  Fine  Control  Options 
access^  through  the  "robo  cop  control"  command.  This  message  allows  the  operator  at 
the  workstation  to  change  key  parameters  for  certain  ivis  reports. 

Message  Type:  19 

SimhostID:  OPFOR_MSG_IVIS_PARAMETERS 

ivis-fine  control-request 


Wrnkstation  ID 
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Content: 

ITEM 

TYPE 

clusterjdistance 

unsigned  int 

decluster_distance 

unsigned  int 

spot_rep_range_threshold 

unsigned  int 

report_m«iitor_time_msec 

max_reappear_latency_msec 

unsigned  int 
unsigned  int 

CQMMEhTT 


base  the  clustering  of  enemy  vehicles  on  this 
distance  in  meters 

distance  at  which  a  cluster  of  vehicles  will  be 
bndcen  into  separate  clusters;  decluster  distance  is 
120%  of  cluster  distance 
send  a  spot  report  when  an  observed  enemy 
vehicle  moves  nxne  than  this  distance  in  meters 
default  time  for  issuing  spot  and  ctmtact  reports 
send  a  craitact  report  if  an  observed  enemy  vehicle 
reappears  after  this  latency  period 


A.2.4  Overlay  Messages 
A.2.4.1  Point  Message 

Description:  A  user  can  create  or  edit  a  point  control  measure  on  the  wori^stadons's  color 

monitor.  When  the  workstation  code  determines  that  the  simhost  needs  to  be  told  that  a 
control  measure  was  created  or  edited,  it  sets  a  send  bit  for  the  control  measure.  This 
message  is  sent  when  the  workstation  calls  for  it  via  the  send  bit  setting. 


Message  Type: 
Simhost  ID: 
Wcxkstation  ID: 
ITEM 

(overlay)  name[20] 
(overlay)  id 
(point)  name[20] 
(point)  id 

X 

y 

(route)  name[20] 

(route)  id 

speed 

cis[40]; 

report 

num_units 

applies_to[32] 
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OPFOR_MSG_POINT 

point-request 

TYPE 

char 

int 

char 

int 

float 

char 

int 

float 

char 

short 

short 

short 


COMMEm- 

user-generated  name  of  the  point’s  overlay 
unique  Symbolics-generated  id  of  point's  overlay 
user-generated  name  of  the  point  control  measure 
unique  Symbolics-generated  id  of  the  point 
x-co(xdinate  of  the  point 
y-coOTdinate  of  the  point 
user-generated  name  of  die  route 
unique  S^bolics-generated  id  of  route 
assign  dus  speed  (loq/hr)  at  this  control  measure 
assign  this  ctxnbat  instructicMi  set  at  this  point 
send  a  report  (^es  or  no)  at  this  control  measure 
number  of  units  in  the  applies.to  array 
apply  this  control  measure  to  these  units 


A.2.4.2  Area  Message 

Description:  A  user  can  create  ot  edit  an  area  control  measure  on  the  workstations's  color 
monitor.  When  the  workstation  code  determines  that  the  simhost  needs  to  be  told  that  a 
control  measure  was  created  or  edited,  it  sets  a  send  bit  for  the  control  measure.  This 
message  is  sent  when  the  workstation  calls  for  it  via  the  send  bit  setting. 

Message  Type:  24 

Simhost  ID:  OPFOR_MSG_AREA 

Wcnkstation  ID:  area-request 

Content:: 


ITEM 

TYPE 

COMMENT 

(overlay)  name[20] 

char 

user-generated  name  of  the  area's  overlay 

(overlay)  id 

int 

unique  Symbolics-generated  id  of  area's  overlay 

(area)  name[20] 

char 

user-generated  name  of  the  area  control  measure 

(area) id 

int 

unique  Symbolics-generated  id  of  the  area 

(waypoint)  count 

int 

number  of  waypoints  in  the  area  perimeter 

waypoints[20] 

float,  float 

X,  y-coordinates  of  the  area  waypoints 

type[20] 

char 

assembly  area  ot  battle  position 

speed 

float 

not  used 

cis[40] 

char 

assign  this  ccHnbat  instruction  set  at  this  control 
measure 

report 

short 

send  a  report  (yes  or  no)  at  this  control  measure 

num_units 

short 

number  of  units  in  the  applies_to  array 

applies_to[32] 

short 

apply  this  control  measure  to  these  units 

A.2.4.3  Zone  Message 

Description:  A  user  can  create  or  edit  a  zonecontrol  measure  on  the  workstaticMis's  color 
monitor.  When  the  woricstation  code  determines  that  the  simhost  needs  to  be  told  that  a 
control  measure  was  created  or  edited,  it  sets  a  send  bit  for  the  control  measure.This 
message  is  sent  when  the  workstation  calls  for  it  via  the  send  bit  setting. 

Message  Type:  25 

Simhost  ID:  OPFOR_MSG_ZONE 

Workstation  ID:  zone-request 
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Content: 

ITEM  TYPE  COMMENT 


(overlay)  name[20] 

char 

(overlay)  id 

int 

(area)  name[20] 

char 

(area) id 

int 

(waypoint)  count 

int 

waypoints[20] 

float,  float 

type[20] 

char 

speed 

float 

cis[40] 

char 

report 

short 

num_units 

short 

applies_to[32] 

short 

user-generated  name  of  the  zme's  ovCTlay 
unique  Symbolics-generated  id  of  ztxie's  overlay 
user-generated  name  of  the  zme  ccmtrol  measure 
unique  Symbolics-generated  id  of  the  zone 
number  of  waypoints  in  the  zone  perimeter 
X,  y-coordinates  of  the  zone  waypoints 
recon  zone  or  no-flre  zone,  not  used 
not  used 

assign  this  ambat  instraction  set  at  this  zone 
send  a  report  (yes  or  no)  at  this  ctHitrol  measure 
number  of  units  in  the  applies_to  array 
apply  this  control  measure  to  these  units 


A.2.4.4  Line  Message 

Description:  A  user  can  create  or  edit  a  line  control  measure  on  the  workstations's  color 
nnonitor.  When  the  workstation  code  determines  that  the  simhost  needs  to  be  told  that  a 
control  measure  was  created  or  edited,  it  sets  a  send  bit  for  the  control  measure.  This 
message  is  sent  when  the  workstation  calls  for  it  via  the  send  bit  setting. 


Message  Type: 
Simhost  ID: 
Workstation  ID: 
Content: 


26 

OPFOR_MSG_LINE 

line-request 


ITEM 

TYPE 

COMMENT 

(overlay)  name[20] 

char 

user-generated  name  of  the  line's  overlay 

(overlay)  id 

int 

unique  Symbolics-generated  id  of  line's  overlay 

(line)  name[20] 

char 

user-generated  name  of  the  line  control  measure 

(line)  id 

int 

unique  Symbolics-generated  id  of  the  line 

(waypoint)  count 

int 

number  of  waypoints  in  the  line 

waypoints[20] 

float,  float 

X,  y-coordinates  of  the  line  waypoints 

spe^ 

float 

assign  this  speed  (km/hr)  at  this  control  measure 

cis[40]; 

char 

assign  this  combat  instruction  set  at  this  line 

report 

short 

send  a  report  (yes  or  no)  at  this  ccmtrol  measure 

num_units 

short 

number  of  units  in  the  applies_to  array 

applies_to[32] 

short 

apply  this  control  measure  to  these  units 
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A.2.4.5  Route  Message 


Description:  A  user  can  create  or  edit  a  route  control  measure  (xi  the  woikstations's  color 

monitor.  When  the  wtxkstation  code  determines  that  the  simhost  needs  to  be  told  that  a 
control  measure  was  created  or  edited,  it  sets  a  send  bit  for  the  control  measure.  This 
message  is  sent  when  the  woiltstation  calls  for  it  via  the  send  bit  setting. 

Message  Type:  27 

Simhost  ID:  OPFOR_MSG_ROUTE 

Woikstation  ID:  route-request 

Content: 

ITEM  TYPE  COMMENT 

(overlay)  name[20]  char  user-generated  name  of  the  route's  overlay 

(overlay)  id  int  unique  Symbolics-generated  id  of  route's  overlay 

(line)  name[20]  char  user-generated  name  of  the  route  control  measure 

(line)  id  int  unique  Symbolics-generated  id  of  the  route 

(waypoint)  count  int  number  of  waypoints  in  the  route 

waypoints[l(X)]  int.  int,  int  a  route  waypoint  can  be  either  a  terrain  point  ot  a 

road  point.  When  the  waypoint  is  on  the  terrain , 
the  tuple  is  an  even-number  id,  x-coord,  y-coord  of 
the  route  waypoint  When  the  waypoint  is  on  a 
road  the  tuple  is  an  odd-number  id,  road  segment 
id,  direction. 

num_units  shon  number  of  units  in  the  applies_to  array 

appUes_to[32]  short  apply  this  control  measure  to  these  units 


A.2.4.6  Delete  Overlay  Message 

Description:  Sent  when  the  user  v  deletes  his  overlays  via  the  Qear  Units  and  Overlays 
command  on  the  color  screen's  Command  Menu  or  the  Clear  command  on  the  Overlay 
Operations  Menu  of  the  commander's  screen.  This  message  tells  the  simhost  to  eliminate 
this  overlay. 

Message  Type:  27 

Simhost  ID:  OPFOR.MSG.DELETE.OVERLAY 

delete-overlay-request 


Woikstatitxi  ID: 


Content: 


nm 


TYPE 


COMMENT 


(overlay)  naiiie[20]  char  user-generated  name  of  the  ovo-lay  to  delete 

(overlay)  id  int  unique  Symbolics-generated  id  of  overlay 


A.2.4.7  Execute  Overlay  Message 

Description:  Sent  when  the  user  issues  an  order  via  the  Execute  Overlay  or  Issue  Frag 
Order  command  on  the  Subontdinate  Unit  Tasking  Display  on  the  conunander's  screen. 
This  message  tells  the  simhost  to  execute  this  overlay.  If  this  is  the  first  time  that  this 
overlay  is  being  asked  to  execute,  all  the  ctMitrol  measures  in  the  overlay  will  also  be  sent 
to  the  simhost. 

Message  Type:  29 

Simhost  ID:  OPFOR_MSG_EXECUTE_OVERLAY 

Workstaticm  ID:  execute-overlay-request 

Ckxitent: 

HEM  TYPE  COMMENT 


(overlay)  name[20]  char 

(overlay)  id  int 

(route)  name[20]  char 

(route)  id  int 

initial_cis[40]  char 


user-generated  name  of  the  overlay  to  use 
unique  Symbolics-generated  id  of  overlay 
user-generated  name  of  the  route  to  follow 
unique  Symbolics-generated  id  of  route 
initial  combat  instruction  set  to  execute 


A.2.4.8  Delete  Control  Measure  Message 

Description:  Sent  when  the  user  deletes  the  control  measures  of  an  overlay  via  the  Gear 
command  on  the  Overlay  Operations  Menu  of  the  ctxnmander’s  screen.  This  message  tells 
the  simhost  to  eliminate  this  control  measure. 

Message  Type:  33 

Simhost  ID:  OPFOR_MSG_DELETE_CM 


Wcxkstation  ID:  delete-cm-request 
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Oxitent: 

ITEM 

TYPE 

(overlay)  name[20] 

char 

(overlay)  id 

int 

(control  measure)  name[20] 

char 

(crmtrol  measure)  id 

int 

CQMMETff 

user-generated  name  of  the  OYCTlay  to  delete 
unique  Symbolics-generated  id  of  overlay 
user-generated  name  of  die  control  measure  to 
delete 

unique  Symbolics-generated  id  of  control  measure 


A.2.5  Immediate  Intervention  Messages 


A.2.5.1  Rejoin  Unit  Message 

Description:  Sent  when  the  user  issues  a  Rejoin  Unit  Immediate  Intcrventiori.  Creels 
an  OTd»  that  was  issued  to  a  subordinate  of  a  unit  and  have  the  subordinate  rejoin  its  unit. 
Reframs  the  parent  unit  by  placing  under  parent  command  the  subordinate  unit  that  was 
separated  fmm  its  parent  An  example  is  the  cancelling  of  a  platoon  order  issued  to  a 
platoon  that  is  part  of  a  company.  The  platoon  stc^s  executing  its  order  and  returns  to 
following  its  company  commander’s  ofoer. 


Message  Type: 
Simhost  ID: 
Workstation  ID: 
Content:: 


44 

OPFOR_MSG_REJOIN_UNIT 
rejoin-unit-request 
0  data;  header  only. 


A.2.5.2  Halt  Message 


Description:  Sent  when  the  user  issues  a  Halt  Immediate  Intervention.  Has  the  vehicles 
stop  in  place. 


Message  Type: 
Simhost  ID: 
Woikstadon  ID: 
Content:: 


30 

OPFOR_MSG_HALT 
halt-request 
0  data;  header  only. 


A.2.5.3  Resume  Message 


Description:  Sent  when  the  user  issues  a  Resume  or  a  Resume-All-Subordinates 

Immediate  Intervention.  Continues  an  interrupted  order.  If  a  unit  has  been  moved  off  of 
its  previously-assigned  route,  it  returns  via  the  shortest  legal  path  and  then  resumes  the 
behavior  assigned  by  the  overlay  under  which  it  was  q)erating. 

Message  Type:  36 

SimhostID:  OPFOR_MSG_RESUME_MISSION 

Wtnkstation  ID:  resume-request 

Content::  0  data;  header  only. 

A.2.5.4  Speed  Message 

Description:  Sent  when  the  user  issues  a  Speed  Immediate  Intervention.  Changes  speed 
to  this  value. 

Message  Type:  31 

Simhost  ID:  OPFOR_MSG_CHANGE_SPEED 

Wtvkstation  ID:  change-speed-request 

Content: 

HEM  TYPE  COMMENT 

speed  int  new  speed  in  km/hr 

A.2.S.S  Formation  Message 

Description:  Sent  when  the  user  issues  a  Formation  Immediate  Intervention.  Changes 
formation  to  this  value. 

Message  Type:  32 

Simhost  ID:  OPFOR_MSG_CHANGE_FORMATION 

Workstation  ID:  change-formation-request 
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Content: 

ITCM 

TYPE 

CQMMEm: 

formation[20] 

char 

name  of  a  S  AF  formatitMi 

A.2.S.6  Follow  Vehicle  Message 


Description:  Sent  when  die  user  issues  a  Follow-Vehicle  Immediate  Intervention.  Has 
unit  follow  a  selected  Geader)  vehicle. 

Message  Type:  34 

SimhostID:  OPFOR_MSG_FOLLOW_VEHICLE 


Wcnicstation  ID: 

Content: 

ITEM 

xoff 

yoff 

leadid 

padding 


follow-vehicle-request 


TYPE  COMMENT 


float 

float 

unsigned  short 
unsigned  short 


x-offset  in  leader's  coordinate  system 
y-offset  in  leader's  coordinate  system 
id  of  the  vehicle  to  follow 


A.2.5.7  Simulator  In  Command  Message 

Description:  Sent  when  the  user  issues  a  Command-From-Simulator  Immediate 
Intervention.  Has  unit  take  direction  from  a  manned  simulator. 


Message  Type: 

Simhost  ID: 

Workstation  ID: 

Qxitent: 

ITEM 

leadid 

padding 
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OPFOR_MSG_SIMULATOR_IN_COMMAND 

simulator-in-command-request 


IXEE  COMMENT 

unsigned  short  id  of  the  commander  vehicle 

unsigned  short 
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A.2.5.8  Go  To  Point  Message 

Description:  Sent  when  the  user  issues  a  Go-To-Locatitxi  Immediate  Interventicxi.  Has 
unit  travel  to  the  given  locatitm. 


Message  Type:  35 

SimhostID:  OPFOR_MSG_GOTO_POINT 


WorkstatitMi  ID: 

Content: 

ITEM 

X 

y 

backwardp 
type 

arrive  at  the  specified  location  There  are  four 
codes  for  the  hold  type: 

HOVER_HOLD  =  0 
ORBIT_HOIT)  =  1 
RACETRACK_HOLD  =  2 
LAND.HOLD  *  3 


go-to-point-request 


TYPE 

COMMENT 

float 

x-coordinate  of  the  locaticHi  to  travel  to 

float 

y-coordinate  of  the  locatitMi  to  travel  to 

int 

travel  in  forward  or  in  reverse 

int 

type  of  hold  fw  air  vehicles  to  use  when  they 

A.2.5.9  Face  Direction  Message 


Description:  Sent  when  the  user  issues  a  Face-Direction  Immediate  Intervention.  Has 
unit  face  the  direction  specified. 


Message  Type: 
Simhost  ID: 
WcHkstaticxi  ID: 
Content: 

ITEM 

mathradians 


37 

OPFOR_MSG_FACE_DIRECnON 

face-direction-request 


type 

float 


COMMENTT 

the  direction  the  unit  is  to  face 


A.2.5.10  Hold  Message 


Description:  Sent  when  the  user  issues  a  Hold  Immediate  Intervention.  Has  unit  hold  in 
the  sp^ified  hold  type. 

Message  Type:  40 

SimhostID:  OPFOR_MSG_HOLD 

Woricstatitm  ID:  hold-request 

Ctmtent: 

ITEM  TYPE  COMMENT 

type  int  type  of  hold  for  air  vehicles  to  use.  There  are  four 

codes  for  the  hold  type: 

HOVER_HOLD  =  0 
ORBIT_HOLD=l 
RACETRACK_HOLD  =  2 
LAND_HOLD  =  3 


A.2.5.11  Altitude  Message 

Description:  Sent  when  the  user  issues  an  Altitude  Immediate  Intervention.  Has  unit 
change  altitude. 

Message  Type:  41 

SimhostID:  OPFOR.MSG.ALTITUDE 

WOTkstation  ID:  change-altitude-request 

Content: 

nm  jm.  comment 

altitude  float  change  altitude  to  this  value  in  meters. 

type  int  type  of  hold  for  air  vehicles  to  use.  There  are  four 

codes  for  the  hold  type: 

ABS_ALTITUDE  =  0 
REL_ALTrnJDE=  1. 
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A.2.5.13  Attack  Message 

Description:  Sent  when  the  user  issues  an  Attack  Immediate  Intervention.  Has  the  air 
unit  attack  according  to  the  attack  type  type.  Omendy  there  is  only  one  attack  profile  that 
both  codes  map  to.  The  air  vehicle  travels  to  the  start  firing  location.  It  begins  to  fire  when 
it  airives  at  the  start  firing  locations.  It  fires  for  ten  seconds  at  targets  nearest  to  the  target 
locatitxi  then  reverses  di^titxi  and  travels  ab<Mit  1  km. 


Message  Type: 


Simhost  ID: 


OPFOR.MSG.ATTACK 


Wcxkstation  ID:  attack-request 

Content: 


ITEM 


IXEE  COMMEbrr 


attack_type 

int 

There  are  two  codes  for  the  attack  type: 
ATTACK  RUNNING  FIRE  =  1 
ATTACK_HOVER_FIRE  =  2. 

start_x 

float 

x-coOTdinate  of  start  firing  location 

start_y 

float 

y-cocmlinate  of  start  firing  location 

taiget_x 

float 

x-coordinate  of  target  location 

taiget_y 

float 

y-coordinate  of  target  location 
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A.2.5.14  Resupply  Message 

Description:  Sent  when  the  user  issues  a  Resupply  Immediate  Interventitm.  Causes  a 
vehicle  to  be  refilled  or  reloaded  fnxn  a  resupply  vehicle. 

Message  Type:  8 

SimhostID:  OPFOR_MSG_RESUPPLY 

Workstation  ID  resupply-request 

Content: 

UEM  TYPE  COMMENT 

iesupply_vehicle  int  vehicle  named  in  header  is  to  be  resupplied  by  this 

vehicle 


A.2.5.15  Targeting  Message 

Description:  Sent  when  the  user  issues  a  Rules-of-Engagement  Immediate  Intervention. 
Sets  the  unit's  targeting  parameters. 

Message  Type:  38 

SimhostID:  OPFOR_MSG_SET_TARGETlNG 

Workstation  ID:  targeting-request 

Content: 


ITEM 

TYPE 

COMMENT 

firestatus 

int 

There  are  three  types  currently  implemented: 

HOLD  FIRE 

FIRE  AT  WILL 

FIRE_AT_POSmON 

max_engagement_range 

int 

can  only  shoot  at  vehicles  within  this  range  in 
meters 

marksmanship 

int 

the  probability  of  hit  multipher 

position_x 

float 

when  firestatus  is  set  to  FffiE_AT_POSrnON,  fire 
at  this  X-coordinate 

position_y 

float 

when  firestatus  is  set  to  FIRE_AT_POSrnON,  fire 
at  this  Y-coordinate 

radius 

float 

fire  at  all  targets  within  the  specified  radius  in 
meters,  when  firestatus  is  set  to 
FIRE_AT_POSITION 

targets[16] 

unsigned  short 

not  used 
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A.2.6  Mif .  Messages 
A.2.6.1  Artillery  Message 

Description:  This  message  instructs  the  simhost  to  generate  MCC-like  artillery.  See 
piosim.c  and  sbx.c.  This  message  can  only  be  requested  by  a  spec^  "bomb-button" 
ccxnmand  that  is  not  generally  n^e  known  to  users  since  artillery  in  SAP  normally  is 
MCC-generated. 


Message  Type: 
Simhost  ID: 
WrakstaticHi  ID: 
Content: 

ITEM 

type 


OPPOR  MSG_ARTY 


arty-request 


TYPE 


mt 


ammo 

fuze 

count 

spread 

position[3] 


mt 

int 

int 

float 

float 


COMMENT 

There  are  three  types  currently  implemented: 
GROUND  -  generate  an  artillery  hit  on  the  ground 
at  the  location  named  in  the  position  field. 
VEHICLE  -  generate  an  artillery  hit  near  the  vehicle 
named  in  the  header. 

DEATH  -  generate  an  artillery  hit  to  the  most 

vulnerable  part  of  the  vehicle 

named  in  the  header. 

see  definitions  in  prosim.c 

see  definitions  in  prosim.c 

number  of  explosions 

place  explosions  randomly  inside  a  square  whose 

side  is  twice  the  value  of  spread 

for  a  ground  explosion,  use  this  as  center 

of  mass  of  explosion 
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• 

A.3  Simhost  to 

Workstation  Message  Descriptions 

A.3.1  Set-Up  Messages 

A.3.1.1  Reset  Message 

Description:  The  reset  is  the  only  message  that  travels  in  both  directions.  A  reset  from 
the  Simhost  instructs  the  Symbolics  to  delete  the  indicated  vehicles.  In  SAP  version 

3.9.10,  global,  not  selective,  reset  is  performed. 

Message  Type: 

2 

Simhost  ID: 

OPFOR_MSG_RESET 

WorkstaticMi  ID: 

reset-request 

Content: 

ITEM 

TYPE 

COMMENT 

flags 

int 

when  set  at  0x0001,  the  message  means  reset  all 
vehicles. 

unit_count 

int 

count  of  relevant  elements  in  the  unit_list  array, 
unused. 

• 

unit_list[32] 

unsigned  int 

delete  these  units  or  vehicles,  unused. 

A.3.2  Combat  Messages 

A.3.2.1  Ground  Impact  Message 

1 

Description:  Sent  in  resptmse  to  a  direct  fire  explosion  that  does  not  impact  a  vehicle. 

The  unit  identifier  in  the  header  will  contain  the  identifier  of  the  attacker  vehicle  to  enable 

the  workstation  color  screen  to  display  which  vehicle  did  the  shooting  (indicated  via  the 
absence  of  solid  circle  at  the  end  of  the  firing  ray)  and  which  location  was  impacted 
(indicated  by  the  presence  of  the  a  solid  white  circle  at  the  end  of  the  firing  ray). 

Message  Type: 

102 

Simhost  ID: 

GROUND_IMPACT_MSG  I 

Wokstation  ID: 

ground-impact 

Content: 

ITEM 

TYPE 

COMMENT 

ammunition 

unsigned  char 

type  of  ammo  in  the  impact  Set  at  0. 

quantity 

unsigned  char 

# 

padding 

short 

locx 

float 

X  coordinate  of  the  impact 

locy 

float 

y  coordinate  of  the  impact 
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A.3.2.2  Vehicle  Impact  Message 


Description:  Sent  in  response  to  a  direa  fire  explositm  on  a  vdiicle.  The  unit  identifier  in 
the  he^r  will  contain  the  identifier  of  the  attacker  vehicle  to  enable  the  workstation  color 
screen  to  display  which  vehicle  did  the  shooting  (indicated  via  the  absence  of  a  solid  circle 
at  the  end  of  the  firing  ray)  and  which  vehicle  was  impacted  (indicated  by  the  presence  of 
the  yellow  solid  circle  at  the  end  of  the  firing  ray). 

Message  Type:  103 

Simhost  ID:  VEfflCLE_IMPACT_MSG 

Workstation  ID:  vehicle-in:q)act 

Ck>ntent: 


ITEM 

TYPE 

COMMENT 

target_id 

int 

id  of  the  vehicle  hit 

round_type 

int 

type  of  round  used  in  the  impact.  Set  at  0. 

burstjength 

int 

impact  burst  quantity 

A.3.2.3  Indirect  Fire  Message 

Description:  Used  to  display  indirect  fire  bursts  on  the  workstation  color  screen. 

Message  Type:  108 

Simhost  ID:  INDIRECT_FIRE_MSG 

Workstation  ID:  indirect-fire 

Content: 

nm  im  comment 

ammunition  unsigned  char  type  of  ammo.  Set  at  0  except  set  at  1  for  mines, 

fuze  unsigned  char  fuze  description.  Set  at  1 

quantity  unsigned  char  indirect  fire  burst  quantity 

rate  unsigned  char  indirect  fire  burst  rate 

indirect_fire_burst[quantity]  float, float,float,  the  array  element  contains  five  items: 

short, short  x-coord  of  burst, 

y-coord  of  burst, 
z-coord  of  burst, 
time  befcne  next  burst, 
padding 
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A.3.3  Simhost  Status  Messages 
A.3.3.1  Vehicle  PAE  Message 


Description:  Sent  in  response  to  creation  on  the  simhost  of  each  vehicle  and  composite. 
It  provides  all  infcxmaticm  (position,  appearance,  and  echelon)  about  a  vehicle  or 
composite. 

Message  Type:  120 

Simhost  ID:  VEHICLE_PAE_MSG 

Woikstation  ID  vehicle-pae 

Ccmtent: 

ITEM  TYPE  COMMENT 


X 

y 

direction_angle 

turret_angle 

icon 


status 

force 

tactics 


marking[ll] 

port_number 


echelon 


job_desc 

superiorjd 

sbx_uniq_id 

top_superior_uniq_id 

relativejd 

inf_count 

inferiors!  8] 


float  SIMNET  x  position 

float  SIMNET  y  position 

float  computed  by  simhost 

float  ccxnputed  by  simhost 

unsigned  char  appearance  confuted  by  simhost 

unsigned  char  SAP  status  data:  immobile,  catastrophic  kill,  etc 

unsigned  char  SIMNET  frace  data 

unsigned  char  SAP  tactics  data:  Warsaw  ot  NATO 

char  bumper  number 

int  p(at  number  for  the  workstation  at  which  this  SAP 

vehicle  was  created  (fw  example,  2054) 
unsigned  char  code  value  from  mappings.lisp  file.  Por  example, 
company,  platoon,  vehicle,  etc. 
unsigned  char  set  to  zero 

unsigned  short  ID  for  superior,  if  any 
unsigned  char  Symbolics  uitique  ID 

unsigned  char  ID  fen*  top  superior 

unsigned  char  relative  position  in  echelon 

unsigned  char  for  composites,  number  of  inferiors 

unsigned  short  for  composites,  the  inferiors 


A.3.3.2  Vehicle  Position  Message 

Description:  Sent  as  the  normal  reply  to  a  polling  request  from  the  woikstation.  A 
vehicle  position  message  for  each  vehicle  is  a  very  frequent  message. 

Message  Type:  121 

Simhost  ID:  VEHICLE_POSmON_MSG 

vehicle-position 


Workstation  ID: 


Content: 


ITEM 

TYPE 

COMMENT 

X 

float 

SIMNET  X  position 

y 

float 

SIMNET  y  position 

direcdon.angle 

float 

computed  by  simhost 

turret_angle 

float 

computed  by  simhost 

A.3.3.3  Vehicle  Load  Message 

Description:  Sent  frequently  to  checlqx>int  a  vehicle’s  ammo  and  fuel  loads.  When  an 
exercise  is  saved  with  the  Save  Exercise  woricstation  command,  the  most  recendy  returned 
ammo  and  fuel  loads  of  the  exercise  vehicles  are  also  saved. 

Message  Type:  127 


Workstation  ID: 

vehicle-load 

Simhost  ID: 

VEHICLE_LOAD_MSG 

Content: 

ITEM 

TYPE 

COMMENT 

loads[4] 

short 

one  level  for  each  weapon  type 

fuel 

int 

fuel  level 

A.3.3.4  Vehicle  Position  Poll  Completed  Message 

Description:  Sent  to  indicate  the  completion  of  the  sending  of  all  the  vehicle  position 
messages  for  this  polling  cycle. 

Message  Type:  122 

SimhostID:  VEfflCLE_POSrnON_POLL_COMPLETED_MSG 

Workstation  ID:  vehicle-position-poll-coti^leted 

Content:  0  bytes;  only  a  header  element  is  needed. 
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A.3.3.S  Vehicle  Appearance  Message 


Description:  Sent  when  a  vehicle  gets  damaged.  This  is  a  medium  frequency  message 
used  to  set  a  vehicle's  tqjpearance. 

Message  Type:  123 

SimhostID:  VEHICLE_APPEARANCE_MSG 

WcxkstatitMi  ID:  vehicle-appearance 


ITEM  TYPE  COMMENT 

icon  unsigned  char  appearance  conq)uted  by  simhost 

status  unsigned  char  SAP  status  data:  immobile,  catastit^hic  kill,  etc 

force  unsigned  char  SIMNET  force  data 

tactis  unsigned  char  SAP  tactics  data:  Warsaw  or  NATO 

marking[ll]  char  bumper  number 

A.3.3.6  Vehicle  Echelon  Message 

Description:  Sent  by  a  composite  when  an  infeilOT  gets  killed.  This  is  a  very  infrequent 
message  used  to  set  a  vehicle's  echelon  infonnation. 

Message  Type:  124 

Simhost  ID;  OPPOR_MSG_VEfflCLE_ECHELON 

Workstation  ID:  Vehicle-echelon 

Content: 


ITEM 

TYPE 

COMMENT 

port_number 

int 

port  number  for  the  workstation  at  which  this  SAP 
vehicle  was  created  (for  example,  2054) 

echelon 

unsigned  char 

code  value  from  mappings.lisp  file.  Por  exan^)le, 
company,  platoon,  vehicle,  etc. 

job_desc 

unsigned  char 

set  to  zero 

superiorjd 

unsigned  short 

ID  for  superior,  if  any 

sbx_uniq_id 

unsigned  char 

Symbolics  unique  ID 

top_superior_uniq_id 

unsigned  char 

ID  for  tcq)  superior 

reiative_id 

unsigned  char 

relative  position  in  echelon 

inf_count 

unsigned  char 

for  composites,  number  of  inferiors 

inferiors[8] 

unsigned  short 

for  composites,  the  inferiors 
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A.3.4  Misc  Messages 
A.3.4.1  Generic  Message 

Description:  Used  to  print  an  aibitraiy  message  at  the  workstation.  The  simhost  will 
both  compose  and  format  the  message  and  dien  send  it  to  the  workstation  fm*  display  to  die 
user. 


Message  Type: 
Simhost  ID: 
Qmtent: 

ITEM 

type 


message[1024] 


125 

GENERIC_MESSAGE_MSG 


TYPE  OOMMEhTT 

int  message  types,  used  to  determine  the  font  cm  the 

message  (hsplay,  are : 

GM_l£\DIO_KffiSSAGE  =  0,  means  display  in 
normal  way 

GM_ERROR_MESSAGE  =  1,  means  display  in 
boldface 

GM_RADIO_ALERT_MESS  AGE  =  2,  means 
display  in  boldface  and  also  beq>  the  workstation. 
This  c^e  is  used  for  issuing  a  user  warning,  such 
as  the  simhost  overload  message, 
char  the  message,  his  string  is  null  terminated. 


A.3.4.2  Stealth  Position  Message 

Eiescription:  Sends  a  stealth  vehicle's  position  information  so  that  a  large  yellow  arrow 
can  be  drawn  on  the  workstation's  color  monitor. 


Message  Type:  126 

Simhost  ID:  STEALTH_POSmON_MSG 

Content: 


ITEM 

TYPE 

COMMENTT 

X 

float 

SIMNET  X  position 

y 

float 

SIMNET  y  position 

direction_angle 

float 

computed  by  simhost 

turTet_angle 

float 

ccxnputed  by  simhost 
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A.3.4.3  Machine  Status  Message 

Description:  Sent  when  the  wcnkstation  connects  to  the  simhost  It  synchnxiizes  the 
workstation  time  with  die  simhost  time. 

Message  Type:  114 

Simhost  ID:  MACHINE_STATUS_MSG 

Content: 

ITEM  TYPE 

real_time_ciock_value  unsigned  int 


COMMENT 
current  simhost  time 
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APPENDIX  B:  SAF  PARAMETER  FILES 


B.l  INTRODUCTION 

This  document  describes  the  parameter  files  of  the  Semi- Automated  Fcxces  (SAF)  segment 
of  the  SIMNET  system.  The  SAF  segment  is  divided  into  three  0>mputer  Software 
Configuration  Items  (CSCIs):  a  Woiitstatitxi  C^CI,  a  Simulation  Host  (Simhost)  CSCI, 
and  a  Parameto'  Editors  CSCTI.  The  SAF  parameter  files  are  accessed  by  all  three  CSCIs. 
During  an  exercise,  the  parameter  files  are  read  by  both  the  Workstation  CSCI  and  the 
Simhost  CSCI.  Qf^ne,  some  of  the  parameter  files  can  be  edited  by  a  ncm-programmer 
using  the  editors  of  the  Parameter  E^tCHS  CSCI. 

The  SAF  hardware  is  composed  of  a  MIPS  M20(X)  simulation  host  (simhost)  which 
generates,  simulates,  and  projects  semi-automated  vehicles  (xito  the  SIMNET  network  and 
a  Symbolics  workstation  used  by  the  SAF  commander  to  control  his  semi-automated 
forces.  The  parameter  files  reside  on  the  Mips  simhost. 


B.2  CONFIGURATION  FILES 

SAF  replicates  outward  behavior  of  all  vehicle  and  weapon  systems  to  a  level  of  realism 
sufficient  for  training  and  combat  development.  The  kinematics  and  dynamics  of  the  SAF 
vehicles  are  indistinguishable  by  soldiers  in  manned  simulators  from  those  expected  of 
manned  simulators.  Similarly,  weapons  systems  exhibit  realistic  rates  of  fire  and  realistic 
trajectories  to  the  same  degree  as  those  modelled  by  manned  weapons  systems.  The 
parameter  file,  config.lisp,  contains  modeling  data  fra*  the  vehicles  and  weapons  simulated 
by  the  SAF  Simhost  CSCI.  It  also  contains  a  description  of  these  modeling  parameters. 

Some  configuration  file  parameters  can  be  edited  via  the  Weapons  Systems  Editor  of  the 
Parameter  ^tors  CSCI.  The  Weapons  Systems  Editor  allows  the  user  to  examine  and 
modify  data  in  tabular  fcxm  on  the  Symbolics  workstation.  In  this  way,  a  SAF  client  can 
insert  classified  data  and  can  modify  the  system  for  combat  development  purposes. 
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The  configuration  file  is  divided  into  five  sections: 


SECTION 


COMMENT 


USSR  VEHICLES  This  section  contains  a  set  of  parameter  names  and  values 

for  the  Soviet  vehicles  modeled  in  SAP.  SAP  version 
3.9.10  models  the  following  Soviet  ground  vehiclesrthe 
t72  tank,  the  bmp2,  the  brnpsa?,  the  sa9,  the  zsu23-4,  and 
the  arcv.  Por  air  vehicles,  SAP  version  3.9.10  models  the 
hind  and  havoc  helicopters,  and  the  su25  fixed  wing 
aircraft. 


US  VEHICLES 


USSR  WEAPONS 


US  WEAPONS 


This  section  contains  a  set  of  parameter  names  and  values 
for  the  US  vehicles  nxxleled  in  SAP.  SAP  version  3.9.10 
models  the  following  US  ground  vehicles:  the  ml  tank,  the 
m2  infantry  fighting  vehicle,  a  hummv-stinger  vehicle,  and 
an  adats  vehicle.  Por  air  vehicles,  SAP  version  3.9.10 
models  the  ohSSd  scout  helicopter,  the  ah64  Apache 
helicopter,  and  the  alO  fixed  wing  airc^t 

This  section  contains  a  set  of  parameter  names  and  values 
for  the  Soviet  weapons  modeled  in  SAP.  SAP  version 
3.9.10  models  the  following  Soviet  weapons:  125mm 
HEAT,  125mm  APDS,  30mm  gun,  30mm  cannon,  23mm 
AA,  57mm  rocket.  Spiral  missile.  Spandrel  missile,  Grail 
missile,  and  Gaskin  missile. 

This  section  contains  a  set  of  parameter  names  and  values 
for  the  American  weapons  modeled  in  SAP.  SAP  version 
3.9.10  models  the  following  US  weapons:  105mm  HEAT, 
105mm  APDS,  25mm  gun,  TOW  missile,  ADATS 
missile,  and  Stinger  missile. 
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PARAMETER 

DESCRIPTIONS 


This  section  contains  the  set  of  configuration  Hie 
parameters  arranged  in  alphabetical  order.  In  SAF 
version  3.9.10,  each  description  is  represented  as  a  tuple 
with  four  elements: 

parameter  naiiK  -  The  parameter  name  maps  to  one  of  the 
parameters  appearing  in  the  sections  described  above. 

edit  indicator  -  The  edit  indicator  has  the  value,  nil,  when 
this  parameter  value  can't  be  changed  by  the  Weapons 
Systems  Editor.  The  edit  indicator  has  the  value,  t,  when 
this  parameter  value  can  be  changed  by  the  Weapons 
Systems  Editor. 

comment  -  The  comment  appears  enclosed  in  double 
quotes.  This  is  the  parameter  description  that  will  be 
shown  to  the  Weapons  Systems  Editor  user. 

values  indicator  -  The  values  indicator  can  contain  either 
the  value,  nil,  or  a  list  of  possible  parameter  values  to  be 
offered  to  the  Weapons  Systems  Editor  user. 
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B.3  ECHELON  FILES 


The  composition  parameters  for  setting  up  the  echelon  config|urati(m  for  the  various  opfor 
(enemy)  units  are  contained  in  the  file  named,  red_echelons.lisp.  The  composition 
parameters  fra*  setting  up  the  echelon  configuraticMi  for  the  various  bluefor  (friendly)  units 
are  contained  in  the  file  named,  blue_echelons.lisp. 

Each  echelon  file  organizes  groups  of  vehicles  into  units,  referred  to  as  composites.  This 
allows  a  single  command  or  change  to  be  given  to  entire  units  or  groups  of  vehicles, 
simplifying  the  task  of  the  person  running  the  vehicles  from  the  workstation.  Composites 
"move"  around  the  database,  taking  their  sub  composites  and  vehicles  with  them.  (The 
composite  location  will  be  the  lead  vehicle  of  that  composite,  or  the  lead  vehicle  of  the 
lead  composite,  etc). 

In  SAP,  a  unit  consists  of  an  echelon/unit-type  pair  (for  example,  platoon/  ada).  Each  of 
these  echelon/unit-type  pairs  has  a  set  of  vehicles  and  composites.  Each  vehicle  in  a  set  of 
vehicles  is  described  by  a  tuple  with  four  elements:  vehicle  type,  least  significant  bumper 
digit(s),  job,  and  rank.  The  vehicle  type  values  map  to  the  vehicles  described  in  the 
configuration  files.  The  least  significant  bumper  digit(s)  is  used  when  a  bumper  number  is 
generated  for  a  vehicle.  The  job  values  correspond  to  the  job  values  in  the  formation 
files,  thereby  specifying  where  each  vehicle  of  a  unit  is  positioned  relative  to  the  other 
vehicles  in  its  unit  for  each  valid  formation.  Rank  is  not  currently  used. 

The  example  below  shows  a  vehicle  tuple  for  the  vehicle/tank  unit.  The  vehicle  type  is  the 
Ml  tank,  die  bumper  digit  is  1,  the  job  is  tp-pc  (platoon  conunander),  and  the  rank  is  3. 

(ml  1  tp-pc  3) 

B.3.1  Red  Echelon  Files 

For  the  red  force,  the  valid  echelon  types  are:  vehicle,  platoon,  company,  flight-of-2, 
flight-of-3  and  flight-of-4.  The  red  ground  forces  make  use  of  the  vehicle,  platoon,  and 
company  echelons.  The  red  air  forces  make  use  of  the  vehicle,  flight-of-2,  flight-of-3  and 
flight-of-4  echelons. 

For  the  red  ground  vehicle  echelon,  the  valid  unit-types  are:  tank,  motorized-rifle,  and  ada. 
The  vehicle/tank  unit  contains  a  t72  vehicle  with  a  job  of  platoon  commander  (^-pc)  and 
bumper  1.  The  vehicle/motorized-rifle  unit  contains  a  bmp2  vehicle  with  a  job  of  platoon 
commander  (mrp-pc)  and  bumper  1.  The  vehicle/ada  unit  contains  a  sa9  vehicle  with  a 
job  of  platoon  commander  (ad-pc)  and  bumper  1. 

For  the  red  platoon  echelon,  the  valid  units  arc:  platoon/tank,  platoon/motorized-rifle, 
and  platoon/ada.  The  vehicles  in  a  red  tank  platoon  (tp),  motorized-rifle  platocm  (mrp), 
and  ada  platoon  (ad)  have  the  following  jobs:  platoon  conunander  (pc),  wing  1  (wl),  wing 
2  (w2),  and  wing  3  (w3). 

The  tank  platoon  contains  the  following  vehicles: 

a  t72  vehicle  for  the  platoon  commander  (^-pc)  with  bumper  1 
a  t72  vehicle  for  the  wing  1  job  (tp-wl)  with  bumper  2 
a  t72  vehicle  for  the  wing  2  job  (tp-w2)  with  bumper  3 
a  t72  vehicle  for  the  wing  3  job  (t^w3)  with  bumper  4. 
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The  motorized-rifle  platoon  contains  the  following  vehicles: 

a  bmp2  vehicle  for  the  platoon  commander  (mrp-pc)  with  bumper  1 
a  bmp2  vehicle  for  the  wing  1  job  (mrp-wl)  with  bun^r  2 
a  bnq)2  vehicle  fca*  the  wing  2  job  (mrp-w2)  with  bumper  3 
a  bmp2  vehicle  for  the  wing  3  job  (mrp-w3)  with  bumper  4. 

The  ada  platomi  contains  the  following  vehicles: 

an  ada  vehicle  for  the  platoon  commander  (ad-pc)  with  bumper  1 
an  ada  vehicle  for  the  wing  1  job  (ad-wl)  with  bunper  2 
an  ada  vehicle  for  the  wing  2  job  (ad-w2)  with  bun^}er  3 
an  ada  vehicle  for  the  wing  3  job  (ad-w3)  with  bunq)er  4. 


For  the  red  (xanpany  echelon,  the  valid  units  are:  company/motorized-rifle- 
reinforced,  company/motorized-rifle,  and  company/tank. 

The  motorized-riflc-reinforccd  company  contains  the  following  vehicles: 
a  bmp2  vehicle  for  the  company  ctxnmander  with  bumper  66 
a  zsu23-4  vehicle  for  the  zsu-23  job  with  bumper  00 
a  bmpsa?  vehicle  for  the  aa-bmp  job  with  bumper  00 
one  motorized-rifle  platoon  (mrpl)  containing: 

a  bmp2  vehicle  for  platoon  ctxnmander  (mipl-pc)  with  bumper  1 1 
a  bmp2  vehicle  for  the  wing  1  job  (mrpl-wl)  with  bumper  12 
a  bmp2  vehicle  for  the  wing  2  job  (mrpl-w2)  with  bumper  13 
one  motoriz^-rifle  platoon  (mrp2)  containing: 

a  bmp2  vehicle  for  platoon  oxnmander  (mrp2-pc)  with  bumper  21 
a  bmp2  vehicle  for  the  wing  1  job  (mrp2-wl)  with  bumper  22 
a  bmp2  vehicle  for  the  wing  2  job  (mip2- w2)  with  bumper  23 
one  motoriz^-rine  platoon  (mrp3)  containing: 

a  bmp2  vehicle  for  platoon  commander  (mip3-pc)  with  bumper  31 
a  bmp2  vehicle  for  the  wing  1  job  (mrp3-wl)  with  bumper  32 
a  bmp2  vehicle  for  the  wing  2  job  (mrp3-w2)  with  bumper  33 
one  tank  platoon  containing: 

a  t72  vehicle  for  the  platoon  commander  (tp-pc)  with  bumper  41 
a  t72  vehicle  for  the  wing  1  job  (tp-wl)  with  bumper  42 
a  t72  vehicle  for  the  wing  2  job  (tp-w2)  with  bumper  43 
a  t72  vehicle  for  the  wing  2  job  (tp-wl)  with  bumper  43. 


The  motorized-rifle  company  contains  the  following  vehicles: 

a  bmp2  vehicle  for  the  company  commander  (co)  with  bumper  66 
one  imtorized-rifle  platoon  (mrpl)  containing: 

a  bmp2  vehicle  for  platoon  ctHiunand^  (mrpl -pc)  with  bumper  1 1 
a  bmp2  vehicle  for  the  wing  1  job  (mrpl-wl)  with  bumper  12 
a  bmp2  vehicle  for  the  wing  2  job  (mrpl-w2)  with  bumper  13 
one  motoriz^-rifle  platoon  (mtp2)  containing: 

a  bmp2  vehicle  for  platoon  commander  (mrp2-pc)  with  bumper  21 
a  bmp2  vehicle  for  the  wing  1  job  (mrp2-wl)  with  bumper  22 
a  bmp2  vehicle  for  the  wing  2  job  (mrp2-w2)  with  bumper  23. 
one  motoriz^-rifle  platoon  (mip3)  containing: 

a  bmp2  vehicle  for  platoon  commander  (mrp3-pc)  with  bumper  31 
a  bmp2  vehicle  for  the  wing  1  job  (mrp3-wl)  with  bumper  32 
a  bmp2  vehicle  for  the  wing  2  job  (mrp3-w2)  with  bumper  33. 
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The  tank  company  contains  the  following  vehicles: 

a  t72  vehicle  for  the  company  commander  (tc-co)  with  bumper  66 
one  tank  platoon  containing; 

a  t72  vehicle  for  the  platoon  commander  (q)  l-pc)  with  bumper  11 
a  t72  vehicle  for  the  wing  1  job  (tpl-wl)  with  bumper  12 
a  t72  vehicle  for  the  wing  2  job  (^l-w2)  with  bumper  13 
one  tank  platoon  containing: 

a  t72  vehicle  for  the  platoon  commander  (q)2-pc)  with  bumper  21 
a  t72  vehicle  for  the  wing  1  job  (tp2-wl)  with  bumper  22 
a  t72  vehicle  fcM"  the  wing  2  job  (^2-w2)  with  bumper  23 
one  tank  platoon  containing: 

a  t72  vehicle  for  the  platoon  commander  (^3-pc)  with  bunq)er  31 
a  t72  vehicle  for  the  wing  1  job  (tp3-wl)  with  bumper  32 
a  t72  vehicle  for  the  wing  2  job  (tp3-w2)  with  bumper  33. 


For  SAF  red  aircraft,  the  echelon/unit-type  pairs  are:  vehicle/fwa,  vehicle/havoc, 
vehicle/hind,  flight-of-2/fwa,  flight-of-2/havoc,  flight-of-2/hind,  flight-of-3/havoc,  flight- 
of- 3/hind,  flight-of-3/fwa,  flight-of-4/havoc,  flight-of-4/hind,  and  flight-of-4/fwa. 

For  the  red  air  vehicle  echelon,  the  valid  unit-types  are:  fwa,  hind,  and  havoc.  The 
vehicle/fwa  unit  contains  a  su25  vehicle  with  a  job  of  leader  and  bumper  1.  The 
vehicle/hind  unit  contains  a  hind  vehicle  with  a  job  of  leader  and  bumper  1.  The 
vehicle/havoc  contains  a  havoc  vehicle  with  a  job  of  leader  and  bumper  1. 

The  flight-of-2/fwa  unit  contains  the  vehicle/fwa  vehicle  plus  an  su25  vehicle  for  the 
wingl  job  with  bumper  2.  The  flight-of-2/havoc  unit  contains  the  vehicle/fwa  vehicle 
plus  a  havoc  vehicle  for  the  wingl  job  wiA  bumper  2.  The  flight-of-2/hind  unit  contains 
the  vehicle/hind  vehicle  plus  a  hind  vehicle  for  the  wingl  job  with  bumper  2. 

The  flight-of-3/fwa  unit  contains  the  flight-of-2/fwa  vehicles  plus  an  su25  vehicle  for  the 
wing2  job  with  bumper  3.  The  flight-of-3/havoc  unit  contains  the  flight-of-2/havoc 
vehicles  plus  a  havoc  vehicle  for  the  wing2  job  with  bumper  3.  The  flight-of-3/hind  unit 
contains  the  flight-of- 3/hind  vehicles  plus  a  hind  vehicle  for  the  wing2  job  with  bumper 

3. 

The  flight-of-4/fwa  unit  contains  the  flight-of-3/fwa  vehicles  plus  an  su25  vehicle  for  the 
wing3  job  with  bumper  4.  The  flight-of-4/havoc  unit  contains  the  flight-of-3/havoc 
vehicles  plus  a  havoc  vehicle  for  the  wingS  job  with  bumper  4.  The  flight-of-4/hind  unit 
contains  the  flight-of-4/hind  vehicles  plus  a  hind  vehicle  for  the  wing3  job  with  bumper 

4. 

B.3.2  Blue  Echelon  Files 

For  the  blue  echelons,  the  valid  echelon  types  arc:  vehicle,  platoon,  company,  flight-of-2, 
flight-of-3  and  flight-of-4.  The  blue  groui^  forces  make  use  of  the  vehicle,  platoon,  and 
company  echelons.  The  blue  air  forces  make  use  of  the  vehicle,  flight-of-2,  flight-of^-3  and 
flight-of-4  echelons. 
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For  the  blue  ground  vehicle  echelon,  the  valid  units  are:  vehicl^tank,  vehicle/mechanized' 
infantry,  and  vehicle/ada.  The  vehicle/tank  unit  contains  an  ml  vehicle  with  a  job  of 
platoon  commander  (tp-pc)  and  bumper  1.  The  vehicle/mechanized-infantry  unit 
contains  an  m2  vehicle  with  a  job  of  platoon  commander  (mp-pc)  and  bumper  1.  The 
vehicle/ada  unit  contains  an  adats  vehicle  with  a  job  of  platoon  ctmunander  (ad-pc)  and 
bumper  1. 

For  the  blue  platoon  echelon,  the  valid  units  are:  platoon/tank,  platoon/mechanized- 
infantry,  platoon/ada.  The  vehicles  in  a  blue  tank  platoon  (tp),  mechanized-infantry 
platoon  (mp),  and  an  ada  platoon  (ad),  have  the  following  jobs:  platoon  commander 
(pc),  wing  1  (wl),  wing  2  (w2),  and  wing  3  (w3). 

The  tank  platoon  OHitains  the  following  vehicles: 

an  ml  vehicle  for  the  platotxi  commander  (tp-pc)  with  bumper  1 
an  ml  vehicle  for  the  wing  1  job  (tp-wl)  with  bumper  2 
an  ml  vehicle  for  the  wing  2  job  (^-w2)  with  bumper  3 
an  ml  vehicle  for  the  wing  3  job  (tp-w3)  with  bumper  4. 

The  mechanized-infantry  platoon  contains  the  following  vehicles: 

an  m2  vehicle  for  the  platoon  commander  (mp-pc)  with  bumper  1 
an  m2  vehicle  for  the  wing  1  job  (mp-wl)  with  bumper  2 
an  ni2  vehicle  for  the  wing  2  job  (mp-w2)  with  bumper  3 
an  m2  vehicle  for  the  wing  3  job  (mp-w3)  with  bumper  4. 

The  ada  platoon  contains  the  following  vehicles: 

an  adats  vehicle  for  the  platoon  commander  (ad-pc)  with  bumper  1 
an  adats  vehicle  for  the  wing  1  job  (ad-wl)  with  bumper  2 
an  adats  vehicle  for  the  wing  2  job  (ad-w2)  with  bumper  3 
an  adats  vehicle  for  the  wing  3  job  (ad-w3)  with  bumper  4. 

For  the  blue  company  echelon,  the  valid  units  are:  company/mechanized-infantry- 
heavy,  company/mechanized-infantry,  company/tank,  and  company/tank-heavy. 

The  mechanized-infantry-heavy  company  ccmtains  the  following: 

an  m2  vehicle  for  the  company  commander  (mc-co)  with  bumper  66 
an  m2  vehicle  for  the  executing  officer  (mc-xo)  wiA  bumper  65 
one  tank  platoon  (tpl)  containing: 

an  ml  vehicle  for  platoon  ctxnmander  job  (tpl -pc)  with  bumper  1 1 
an  ml  vehicle  for  the  wing  1  job  (tpl-wl)  with  bumper  12 
an  ml  vehicle  for  the  wing  2  job  (tpl-w2)  with  bumper  13 
an  ml  vehicle  for  the  wing  3  job  (tpl-w3)  with  bumper  14 
one  mechanized  infantry  platoon  (mp2)  containing: 

an  m2  vehicle  for  the  platoon  commander  (mp2-pc)  with  bumper  21 
an  m2  vehicle  for  the  wing  1  job  (mp2-wl)  with  bumper  22 
an  m2  vehicle  for  the  wing  2  job  (mp2-w2)  with  bumper  23 
an  m2  vehicle  for  the  wing  3  job  (mp2-w3)  with  bumper  24 
one  mechanized  infantry  platoon  (mp3)  containing: 

an  m2  vehicle  for  the  platoon  commander  (mp3-pc)  with  bumper  31 
an  m2  vehicle  for  the  wing  1  job  (mp3-wl)  with  bumper  32 
an  m2  vehicle  for  the  wing  2  job  (mp3-w2)  with  bumjjer  33 
an  m2  vehicle  for  the  wing  3  (mp3-w3)  with  bumper  34. 
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The  mechanized-infantry  company  contains  the  following: 

an  m2  vehicle  for  the  company  commander  (mc-co)  with  bumper  66 
an  m2  vehicle  for  the  executing  officer  (mc-xo)  with  bumper  65 
one  mechanized  infantry  platoon  (mpl)  containing: 

an  m2  vehicle  for  the  platoon  commander  (mpl-pc)  with  bumper  1 1 
an  ni2  vehicle  for  the  wing  1  job  (mpl-wl)  with  bumper  12 
an  m2  vehicle  for  the  wing  2  job  (mpl-w2)  with  bumper  13 
an  m2  vehicle  for  the  wing  3  job  (mpl-w3)  with  bumper  14 
one  mechanized  infantry  platoon  (mp2)  containing: 

an  m2  vehicle  for  the  platoon  commander  (ii^2-pc)  with  bumper  21 
an  m2  vehicle  for  the  wing  1  job  (mp2-wl)  with  bumper  22 
an  m2  vehicle  for  the  wing  2  job  (mp2-w2)  with  bumper  23 
an  m2  vehicle  for  the  wing  3  job  (mp2-w3)  with  bumper  24 
one  mechanized  infantry  platoon  (mp3)  containing: 

an  m2  vehicle  for  the  platoon  commander  (n:q)3-pc)  with  bumper  31 
an  m2  vehicle  for  the  wing  1  job  (mp3-wl)  with  bumper  32 
an  m2  vehicle  for  the  wing  2  j<^  (mp3-w2)  with  bumper  33 
an  m2  vehicle  for  the  wing  3  job  (mp3-w3)  with  bumper  34. 

The  tank  company  contains  the  following: 

an  ml  vehicle  for  the  company  commander  (tc-co)  with  bumper  66 
an  ml  vehicle  for  the  executing  officer  (tc-xo)  wiA  bumper  65 
one  tank  platoon  (^1)  containing: 

an  ml  vehicle  for  the  platoon  commander  (tpl-pc)  with  bumper  1 1 
an  ml  vehicle  for  the  wing  1  job  (tpl-wl)  with  bumi)er  12 
an  ml  vehicle  for  the  wing  2  job  (tpl-w2)  with  bumper  13 
an  m'  vehicle  for  the  wing  3  job  (^l-w3)  with  bumper  14 
one  tank  platoon  (tp2)  containing: 

an  ml  vehicle  for  the  platoon  commander  (tp2-pc)  with  bumper  21 
an  ml  vehicle  for  the  wing  1  job  (tp2-wl)  with  bumper  22 
an  ml  vehicle  for  the  wing  2  job  (^2-w2)  with  bumper  23 
an  ml  vehicle  for  the  wing  3  job  (^2-w3)  with  bumper  24 
one  tank  platoon  (^3)  containing: 

an  ml  vehicle  for  the  platoon  commander  (tp3-pc)  with  bumper  31 
an  ml  vehicle  for  the  wing  1  job  (tp3-wl)  with  bumper  32 
an  ml  vehicle  for  the  wing  2  job  (tp3-w2)  with  bumper  33 
an  ml  vehicle  for  the  wing  3  job  (tp3-w3)  with  bumper  34. 

The  tank-heavy  company  contains  the  following: 

an  ml  vehicle  for  the  company  commander  (tc-co)  with  bumper  66 
an  ml  vehicle  for  the  executing  officer  (tc-xo)  with  bumper  65 
one  mechanized-infantry  platoon  (mpl)  containing: 

an  m2  vehicle  for  the  platoon  commander  (mpl-pc)  with  bumper  1 1 
an  m2  vehicle  for  the  wing  1  job  (mpl-wl)  with  bumper  12 
an  m2  vehicle  for  the  wing  2  job  (mpl-w2)  with  bumper  13 
an  m2  vehicle  for  the  wing  3  job  (mpl-w3)  with  bumper  14 
one  tank  platoon  (tp2)  containing: 

an  ml  vehicle  for  the  platoon  commander  (tp2-pc)  with  bumper  21 
an  ml  vehicle  for  the  wing  1  job  (tp2-wl)  with  bumper  22 
an  ml  vehicle  for  the  wing  2  job  (tp2-w2)  with  bumper  23 
an  ml  vehicle  for  the  wing  3  job  (tp2-w3)  with  bumper  24 
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one  tank  platoon  (tp3)  containing: 

an  ml  vehicle  for  the  plamon  commander  (q)3-pc)  with  bumper  31 
an  ml  vehicle  for  the  wing  1  job  (tp3-wl)  with  bumper  32 
an  ml  vehicle  for  the  wing  2  job  (^3-w2)  with  bumper  33 
an  ml  vehicle  for  the  wing  3  job  (tp3-w3)  with  bumper  34. 

For  S AF  blue  aircraft,  the  echelcHi/unit-type  pairs  are:  vehicle/fwa,  vehicle/attack-rwa, 
vehicle/scout-rwa,  flight-of-2/fwa,  flight-of-2/attack-rwa,  flight-of-2/scout-rwa,  flight-of- 
3^wa,  flight-of-3/attack-rwa,  flight-of-3/scout-rwa,  flight-of-4/fwa,  flight-of-4/attack- 
rwa,  and  flight-of-4/scout-rwa. 

For  the  blue  air  vehicle  echelon,  the  valid  units  are:  vehicle/fwa,  vehicle/scout-rwa  and 
vehicle/attack-rwa.  The  vehicle/fwa  unit  contains  an  alO  vehicle  with  a  job  of  leader  and 
bumper  1.  The  vehicle/attack-rwa  unit  contains  an  ah64  vehicle  with  a  job  of  leader  and 
bumper  1.  The  vehicle/scout-rwa  contains  an  0hS8d  vehicle  with  a  job  of  leader  and 
bumper  1. 

The  flight-of-2/fwa  unit  contains  the  vehicle/fwa  vehicle  plus  an  alO  vehicle  for  the  wingl 
job  wiA  bumper  2.  The  flight-of-2/attack-rwa  unit  contains  the  vehicle/attack-rwa 
vehicle  plus  an  ah64  vehicle  for  the  wingl  job  with  bumper  2.  The  flight-of-2/scout-rwa 
unit  contains  the  vehicle/scout-rwa  vehicle  plus  an  OhSSd  vehicle  for  the  wingl  job  with 
bumper  2. 

The  flight-of-3/fwa  unit  contains  the  flight-of-2/fwa  vehicles  plus  an  alO  vehicle  for  the 
wing2  job  with  bumper  3.  The  flight-of-3/attack-rwa  unit  contains  the  flight-of-2/attack- 
rwa  vehicles  plus  an  ah64  vehicle  for  the  wing2  job  with  bumper  3.  The  flight-of-3/scout- 
rwa  unit  contains  the  flight-of-2/scout-rwa  vehicles  plus  an  oh58d  vehicle  for  the  wing2 
job  with  bumper  3. 

The  flight-of-4/fwa  unit  contains  the  flight-of-3/fwa  vehicles  plus  an  alO  vehicle  for  the 
wing3  job  with  bumper  4.  The  flight-of-4/attack-rwa  unit  contains  the  flight-of-3/attack- 
rwa  vehicles  plus  an  ah64  vehicle  for  the  wing3  job  with  bumper  4.  The  flight-of-4/scout- 
rwa  unit  contains  the  flight-of-3/scout-rwa  vehicles  plus  a  oh58d  vehicle  for  the  wing3  job 
with  bumper  4. 
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B.4  FORMATION  FILES 

The  positioning  parameters  of  the  various  red  force  units  are  contained  in  the  file  named, 
red_forms.lisp.  The  positioning  parameters  of  the  blue  force  formations  are  contained  in 
the  file  named,  blue_forms.lisp. 

Vehicles  are  set  up  in  positicms  reladve  to  other  vehicles  in  the  composite  and 
sub  composite  structure  through  the  use  of  the  formation  files.  The  Simhost  CSCI  uses 
the  formaticMi  data  (for  example,  who  will  follow  who  in  formation  keeping,  spacing)  to 
place  the  vehicles  of  a  unit  into  their  proper  positicxi.  Note  that  who  a  vehicle  follows  is 
not  usually  the  vehicle  it  takes  orders  from. 

In  SAF,  a  unit  consists  of  an  echelon/unit-type  pair  (for  example,  platoon/ada).  Each  of 
these  units  has  a  set  of  valid  formations,  ^ch  valid  formation  contains  a  table 
of  positioning  tuples  for  each  vehicle  in  the  unit.  Each  tuple  consists  of  three  elements:  a 
vehicle  job,  an  x  coordinate,  and  a  y  coordinate.  The  example  below  shows  a  table  for  the 
road  formation  of  an  ada  platoon.  The  jobs  are  ad-pc  (platoon  commander),  ad-wl 
(wingman  1),  ad-w2  (wingman  2),  and  ad-w3  (wingman  3).  These  are  the  same  jobs 
found  in  the  echelon  file. 

Job  X  y 


ad-w3  0  225 

ad-pc  0  150 

ad-wl  0  75 

ad-w2  0  0 

The  positioning  values  (x,y)  of  the  formation  tables  can  easily  be  changed  by  using  the 
Formations  Editor  component  of  the  Parameter  Editors  CSCI.  The  Formations  Editor 
allows  the  user  to  examine  and  modify  data  in  both  tabular  and  graphical  form  on  the 
Symbolics  workstation.  In  this  way,  a  SAF  client  can  insert  classified  data  and  can 
modify  the  formations  for  combat  development  purposes. 

B.4.1  Red  Formations  File 

In  SAF  version  3.9.10,  the  echelon  names  are  vehicle,  platoon,  flight-of-2,  flight-of- 
3,  flight-of-4  and  company.  The  vehicle  echelon  implies  a  single  vehicle  and  therefore 
does  not  map  to  any  formations.  Formations  are  provided  for  ^e  other  echelons  in  the 
formations  file,  red_forms.lisp. 

The  red  formations  file  is  divided  by  echelon  name  into  five  sections: 

1  Platoon  Formations  -  This  section  contains  a  set  of  fcmnations  (road,  line,  echelon- 
right,  echelon-left,  wedge,  vee,  and  air  raid)  fw  the  following  unit-types: 

Ada-  An  ada  platoon's  only  job  in  SAF  version  3.9.10  is  to  be  the  single 
platoon  of  the  platoon/ada  unit.  Therefore,  only  one  table  of  posidoning  tuples  is 
needed  for  each  on  the  platoon  formadons. 

Tank-  It  is  possible  for  a  platoon  of  a  company  to  operate  independently. 
Therefore,  in  SAF  version  3.9.10  there  are  four  tables  (one  each  for  tp,  tpl,  tp2, 
and  tp3)  of  posidoning  tuples  for  each  of  the  platoon  formadons. 
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Motorized-rifle  -  It  is  possible  for  a  platoon  of  a  company  to  operate  independently. 
Therefore,  in  SAP  version  3.9.10  there  are  four  tables  (one  each  for  n^,  mrpl, 
mrp2,  and  mrp3)  of  positioning  tuples  for  each  of  the  platoon  formations. 

2  Company  Pormations  -  This  section  contains  a  set  of  formations  (attack,  road,  line, 
wedge,  vee,  march-internal,  march-rear,  battle-position,  occupy-area,  and  air  raid) 
for  the  following  unit-types: 

Motorized-rifle-reirforced  (MRR)  -  One  table  of  positioning  tuples  is  provided 
for  each  on  Ae  company  formations. 

Motorized-rifle  (MR)  -  One  table  of  positioning  tuples  is  provided  for  each  on  the 
company  formations. 

Tank  -  One  table  of  positioning  tuples  is  provided  for  each  on  the  company 
formations. 

3  Plight-of-2  Pormations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types:  fwa,  havoc,  and  hind.  Pigure  4-1  shows  the  valid  formations  for  the 
flight-of-2  units. 

4  Plight-of-3  Pormations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types:  fwa,  havoc,  and  hind.  Pigure  4-1  shows  the  valid  formations  for  the 
flight-of-3  units. 

5  Plight-of-4  Pormations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types:  fwa,  havoc,  and  hind.  Pigure  4-1  shows  the  valid  formations  for  the 
flight-of-4  units. 
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Red  Flight-of-2  Formations 
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Red  Flight-of-3  Formations 
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Red  Flight-of-4  Formations 
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B.4.2  Blue  Formations  File 

In  SAF  version  3.9.10,  the  echelon  names  are  vehicle,  platoon,  flight-of-2,  flight-of- 
3,  flight-of-4  and  company.  The  vehicle  echelon  implies  a  single  vehicle  and  therefore 
does  not  map  to  any  formations.  Formations  are  provided  for  the  other  echelons  in  the 
file,  blue_fonns.lisp. 

The  blue  formations  file  is  divided  by  echelon  name  into  five  sectitms; 

1  Platoon  Formations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types: 

Ada  -  An  ada  platoon's  only  job  in  SAF  version  3.9.10  is  to  be  the  single 
platoon  of  the  platoon/ada  unit  Therefore,  cwily  one  table  of  positioning  tuples  is 
needed  for  each  cm  the  following  formations:  road,  staggered-column,  Une, 
echelon-right,  echelon-left,  wedge,  vee,  and  air  raid. 

Tank  -  It  is  possible  for  a  platoon  of  a  company  to  operate  independently. 

Therefore,  in  SAF  version  3.9.10  there  are  four  tables  (one  each  for  tp,  tpl,  tp2, 
and  tp3)  of  positioning  tuples  for  each  of  the  following  formations:  road,  staggered- 
column,  line,  echelon-right,  echelon-left,  wedge,  vee,  and  air  raid. 

Mechanized-infantry  -  It  is  possible  fw  a  platoon  of  a  company  to  operate 
independendy.  Therefore,  in  SAF  version  3.9.10  there  are  four  tables  (one  each 
for  mp,  mpl,  mp2,  and  mp3)  of  positioning  tuples  for  each  of  the  following 
formations:  road,  staggered-column,  line,  echelon-right,  echelon-left,  wedge,  vee, 
scout,  and  air  raid. 

2  Company  Formations  •  This  section  contains  a  set  of  formations  (attack,  road,  line, 
wedge,  vee,  march-internal,  march-rear,  battle-position,  occupy-area,  and  air  raid) 
for  the  following  unit  types: 

Mechanized-infantry  -  One  table  of  positioning  tuples  is  provided  for  each  on  the 
company  formations  listed  above. 

Mechanized-infantry  -heavy  One  table  of  positioning  tuples  is  provided  for  each 
on  the  company  formations  listed  above. 

Tank  -  One  table  of  positioning  tuples  is  provided  for  each  on  the  company 
formations  listed  above. 

Tank-heavy-  One  table  of  positioning  tuples  is  provided  for  each  on  the  company 
formations  listed  above. 

3  Flight-of-2  Formations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types:  fwa,  scout-rwa,  and  attack-rwa.  Figure  4-2  shows  the  valid  formations 
for  the  flight-of-2  units. 

4  Flight-of-3  Formations  -  This  section  contains  a  set  of  formations  for  the  following 
unit  types:  fwa,  scout-rwa,  and  attack-rwa.  Figure  4-2  shows  the  valid  formations 
for  the  flight-of-3  units. 
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5  Flight-of-4  Formations  -  This  section  contains  a  set  of  ftHtnations  for  the  following 
unit  types:  fwa,  scout-rwa,  and  attack-rwa.  Figure  4-2  shows  the  valid  formations 
for  the  flight-of-4  units. 
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Figure  4-2:  Blue  Air  Formations 
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B.5  COMBAT  INSTRUCTION  SET  FILES 


A  military  qreraticHi  fa*  the  units  under  command  is  specified  via  a  Combat  Instruction  Set 
(CIS),  which  corresponds  to  a  battle  drill  since  it  defines  a  standardized  form  of  behavicn*. 
The  parameters  for  the  combat  instructicxi  sets  of  the  red  force  units  are  contained  in  the  file 
nam^,  red_cis.lisp.The  parameters  for  the  combat  instmction  sets  of  the  blue  force  units 
are  contained  in  the  file  named,  blue_cis.lisp. 

Aggregate  levels,  from  platoons  up  to  companies,  are  ctMitroUed  by  doctrinal  tactics 
involving  CIS  necessary  to  cany  out  the  fwdamental  tasks  of  move,  shoot,  communicate. 
Via  the  workstaticm,  the  SAP  commander  is  able  to  have  a  QS  executed.  I^fault  values 
are  provided  by  the  SAP  system  for  parameters,  these  values  being  drawn  from  standard 
military  doctrine.  However  these  default  values  are  open  to  modification  by  the  SAP 
commander. 

During  the  planning  process,  a  workstation  commander  can  tag  a  control  measure  with  a 
CIS  so  that  a  unit  executes  that  CIS  upon  reaching  the  tagged  control  measure.  With  a 
CIS,  the  SAP  system  will  take  charge  and  generate  all  the  detailed  instructions  needed  to 
make  the  units  involved,  down  to  the  last  vehicle,  behave  in  accordance  to  the  CIS.  Thus, 
for  a  tank  company  attack  CIS,  appropriate  formation  and  speeds  will  be  passed  along  all 
the  way  down  to  individual  vehicles.  In  this  way,  all  of  the  company  units  will  act  in  a 
coordinated  maimer  in  support  of  the  CIS. 

A  CIS  usually  begins  intentionally;  in  other  words,  it  begins  when  the  SAP  CMiunander 
tells  it  to  via  subordinate  unit  tasl^g  or  when  die  route  teing  travelled  by  a  unit  crosses  a 
control  measure  that  is  both  tagged  with  that  CIS  and  assigned  to  that  unit.  Some  CIS  are 
spontaneous  which  means  they  are  generated  automadcally  through  what  is  called  a 
situational  interrupt.  Pot  example,  when  hit  by  a  surprise  attack,  vehicles  in  a  unit  seek  the 
high  ground  between  themselves  and  the  enemy  without  the  SAP  commander  having  to 
micro-manage  the  platoons  or  individual  vehicles. 

The  following  are  examples  of  situational  intemipts: 

Por  companies: 

A  ground  enemy  engagement  can  force  a  Hasty-Attack  CIS  -  If  a  threat  of  attack 
occurs  (four  or  more  forward  or  advancing  enemy  ground  vehicles  within  2000 
meters),  the  company  moves  into  an  attack  position  (line)  and  stops  advancing  at 
the  high  ground  between  itself  and  the  enemy.  It  then  awaits  further  orders. 

An  air  strike  forces  a  React-to-Air-Raid  CIS  -  If  an  air  strike  occurs  while  a 
company  is  in  one  of  the  march  ot  prebatde  combat  instruction  sets,  stagger  the 
formation  by  having  the  vehicles  move  100  meters  to  either  side  of  its  centerline(air- 
raid  formation)  and  then  engage  aircraft  After  three  minutes  of  no  firing,  the 
vehicles  resume  the  original  CIS.  The  React-To-Air-Raid  CIS  is  the  only  CIS  that 
actually  ends  on  its  own.  It  ends  when  three  minutes  elapse  without  an  air  strike. 

At  that  time  the  SAP  system  automatically  transitions  the  unit  back  to  its  current  QS 
(the  CIS  it  was  executing  before  it  needed  to  jump  into  the  React-To-Air-Raid  CIS) 
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For  platoons: 

Action  Drill  Needed  -  If  a  platoon  is  engaged  by  2  ot  more  advancing  or  forward 
enemy  ground  vehicles  within  2000  meters  then  it  moves  into  an  attack  position 
Cine)  facing  the  enemy  center  of  mass  and  stops  advancing  when  it  gets  to  the  high 
ground  in  tont  of  the  enemy.  It  remains  there  engaging  enemy  and  awaits  further 
orders. 

Each  CIS  contains  a  default  ^)eed  and  formation.  An  immediate  intervention  or  a  control 
measure  intersection  can  cause  a  speed  change  and  can  cause  a  unit  to  transition  to  one  of 
its  valid  formations.  Even  though  a  unit  does  stop  nK>ving  when  it  reaches  the  end  of  a 
route,  it  will  still  be  in  a  state  of  executing  the  current  CIS  and  will  therefcne  need  to  check 
for  situational  interrupts. 

The  exan^le  below  shows  a  sample  QS  enny  (named  action-drill)  and  explains  how  the 
Simhost  CSCI  interprets  it. 

(action-drill) 

(parameters) 

(control-measures) 

(situational  t) 

(resumable  t) 

(formation  line) 

(speed  25) 

(move  high-ground) 

(communicate  "Commencing  action  drill") 

(enahled-predicates)) 

The  action-drill  CIS  directs  the  platoon  to  assunx;  the  line  formation,  adjust  its  speed  to  25 
kph,  move  to  the  high  ground  between  itself  and  the  enemy,  and  then  stop  and  turn  to  face 
the  enemy  center  of  mass.  The  message,  '(Commencing  action  drill',  will  be  sent  to  the 
workstation  to  confirm  the  perfcxmance  of  this  CIS.  "niis  CIS  has  no  enabled-predicates 
so  the  CIS  ends  when  the  unit  receives  another  task  via  subordinate  unit  tasking.  The 
tuple,  (resumable  t),  indicates  that  this  CIS  is  resumable.  This  means  that  if  the  user  issues 
a  RESUME  immediate  intervention,  the  unit  will  continue  to  travel  along  the  route  it  was 
following  before  transitioning  to  the  action-drill  CIS.  When  the  route  is  resumed,  the  unit 
advances  to  the  waypoint  it  was  heading  for  when  the  situational  interrupt  occured. 

In  SAF  version  3.9.10,  each  CIS  contains  nine  entries: 

1  parameters  -  currently  unused.  Later  versions  of  SAF  intend  to  give  the  user  more 
ability  to  change  default  CIS  parameter  values  (such  as  speed). 

2  control-measures  -  possible  values  are  derived  from  the  set  of  control  measures  that 
this  CIS  can  be  tagged  to.  (Currently  the  set  includes  the  following:  point,  line,  zone 
and  area. 

3  situational  -  possible  value  is  t  or  nil.  A  value  of  t  indicates  that  this  CIS  can  be 
transitioned  to  automatically  by  one  of  the  situational  interrupts  described  above.  A 
value  of  nil  indicates  that  this  CIS  is  (xily  executed  by  direct  intent  of  the  user. 
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4  resumable  -  possible  value  is  t  or  nil.  The  tuple,  (resumable  t),  indicates  that  this 
CIS  is  resumable.  This  means  that  if  the  user  issues  a  RESUl^  immediate 
intervention,  the  unit  will  continue  to  travel  along  the  route  it  was  following  when 
the  situational  interrupt  occurred.  The  tuple,  (resumable  nil),  indicates  that  this  CIS 
is  not  resumable.  This  means  that  if  the  user  issues  a  RESUl^  immediate 
intervention,  the  unit  will  ignore  it 

5  formation  -  possible  value  is  one  of  the  formation  names  given  in  the  fcnmation  file. 
The  unit  is  directed  to  assume  this  formation  when  it  executes  this  CIS. 

6  speed  -  possible  value  is  a  speed  in  kph  to  indicatethe  speed  the  unit  is  to  assume 
when  executing  this  CIS. 

7  move  -  possible  values  are  one  of  the  following: 

halt  JO  indicate  that  the  vehicles  are  to  stc^  moving 

withdrawing  to  indicate  that  the  vehicles  are  to  travel  along  the  withdraw  route  with 
their  hulls  at  0  mils  relative  to  the  route  and  their  turrets  at  3200  mils  relative  to  their 
hulls. 

high-ground  to  indicate  that  the  vehicles  are  to  advance  to  the  highest  point  between 
themselves  and  the  enemy 

along-route  to  indicate  that  the  vehicles  are  to  continue  on  their  route. 

8  communicate  -  value  is  a  string  that  will  be  displayed  in  the  Message  Log  Pane  when 
the  unit  begins  executing  this  CIS. 

9  enabled-predicates  -  value  is  the  name  of  any  tests  that  need  to  be  performed  while 
the  unit  is  executing  this  CIS. 

B.5.1  Red  CIS  File 

In  SAF  version  3.9.10,  the  echelon  names  are  vehicle,  platoon,  company,  flight-of-2, 
flight-of-3,  and  flight-of-4.  The  vehicle  echelon  implies  a  single  vehicle  and  therefore  does 
not  need  any  CIS.  CIS  are  provided  for  the  other  echelons  in  the  file,  red_cis.lisp. 

The  red  CIS  file  is  divided  by  echelon  name  into  five  sections: 

1  Company  CIS  -  In  SAF  version  3.9. 10,  there  are  twelve  implemented  Red  Company 
CIS:  occupy-assembly-area,  roadmarch,  march-as-intemal,  march-as-rear,  pre¬ 
battle-wedge,  pre-battie-line,  pre-battle-vee,  attack,occupy-battle-position, 
withdraw,  hasty-attack,  and  react  to  air-raid. 

2  Platoon  CHS  -  In  SAF  version  3.9.10,  there  are  six  implemented  Red  Platoon  QS: 
roadmarch,  assault,  occupy-assembly-area,  occupy-battle-position,  withdraw,  and 
action-drill. 

3  Flight-of-2  CIS  -  In  SAF  version  3.9.10,  there  are  no  implemented  air  CIS. 

4  Flight-of-3  CIS  -  In  SAF  version  3.9.10,  there  are  no  implemented  air  CIS. 

5  Flight-of-4  CIS  -  In  SAF  version  3.9.10,  there  are  no  implemented  air  CIS. 
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B.5.2  Blue  CIS  File 

In  SAP  version  3.9.10,  the  echelon  names  are  vehicle,  platoon,  company,  flight-of-2, 
flight-of-3,  and  flight-of-4.The  vehicle  echelon  implies  a  single  vehicle  and  therefore  does 
not  need  any  CIS.  CIS  are  pnmded  fo'  the  other  echelons  in  the  file,  blue_cis.lisp. 

The  blue  CIS  file  is  divided  by  echelon  name  into  five  sections: 

1  Company  CIS  -  In  SAP  version  3.9.10,  there  are  eight  implemented  Blue  Ccanpany 
CIS:  occupy-assembly-area,  roadmarch,  move-in-wedge,  move-in-vee,  attack, 
occupy-batUe-position,  hasty-attack,  and  react  to  air-raid. 

2  Platoon  CIS  -  In  SAP  version  3.9.10,  there  are  twelve  implemented  Blue  Platoon 
CIS:  roadmarch,  combat-fcHmation-column,  combat-formaticMi-line,  combat- 
formation- wedge,  oxnbat-formation-vee,  combat-formation-echelon-left,  combat- 
formation-echelon-right,  assault,  occupy-assembly-area,  occupy-battle-position, 
withdraw,  and  action-drill. 

3  Plight-of-2  CIS  -  In  SAP  version  3.9.10,  there  are  no  implemented  air  CIS. 

4  Plight-of-3  CIS  -  In  SAP  version  3.9.10,  there  are  no  implemented  air  CIS. 

5  Plight-of-4  CIS  -  In  SAP  version  3.9.10,  there  are  no  implemented  air  CIS. 
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B.6  PROBABILITY  OF  DETECTION  FILES 

The  probability  of  detection  tables  for  both  the  red  and  blue  fnce  are  located  in  the  file 
named  detection.lisp. 

The  intervisibility  algorithm  is  based  on  the  idea  of  running  a  ray  from  an  eye  point  to  a 
target  and  checkmg  whether  the  ray  encounters  any  obstacles  (can  we  see  frcan  the  ray  start 
point  to  the  target).  The  algorithm  will  detect  bo^  terrain  and  structural  obstacles.  A 
target  is  fully  visible  when  there  are  no  obstacles  between  the  eye  point  and  the  bottom  of 
the  target.  A  target  is  partly  visible  when  there  are  obstacles  between  the  eye  point  and  the 
bottom  of  the  target  but  no  obstacles  between  the  eye  point  and  the  top  of  Ae  target,  for 
example  a  hull  down  tank.  A  target  is  invisible  when  there  are  obstacles  between  the  eye 
point  and  the  top  of  the  target.  U  there  is  no  line  of  sight  between  the  target  and 
the  observer,  then  the  probability  of  detection  is  zero. 

Probability  of  detection  tables  vary  according  to  the  state  of  the  target  (target  aspect), 
range,  and  arc  of  observation.  The  states  of  the  target  are:  partially  visible  (hull 
defilade),  fully  visible  stationary  (stationary)  and  fully  visible  moving  (moving).  If 
the  target  is  partially  visible,  for  example  hull  down  or  occluded  by  terrain,  then  the 
probability  of  detection  is  reduced  from  that  for  a  fully  visible  target  The  observation  and 
surveillance  capabilities  of  the  crew  are  aggregated  for  simplicity  by  the  concept  of  arcs  of 
observation.  TTie  primary  arc  of  observation  (120  degrees)  is  centered  on  the  armament  or 
main  axis  of  the  platform.  If  the  target  is  not  within  the  primary  arc,  a  secondary  arc 
detection  probability  table  is  used. 

The  detection  file  contains  four  sections: 

1  Primary  Arc  Probability  of  Detection  for  an  Air  Vehicle 

2  Secondary  Arc  Probability  of  Detection  for  an  Air  Vehicle 

3  Primary  Arc  Probability  of  Detection  for  a  Ground  Vehicle 

4  Secondary  Arc  Probability  of  Detection  for  a  Ground  Vehicle. 

Each  secilcr.  ^.ontains  three  probability  tables,  one  for  each  target  aspect  (stationary, 
moving,  or  hull  defilade).  TTie  table  consists  of  a  set  of  tuples  with  two  elements:  a  range 
and  a  probability  of  detection  at  that  range. 

The  range  and  probability  values  of  the  detection  tables  used  by  the  SAP  Simhost 
CSCI  can  easily  be  changed  by  using  the  Model  Editor  component  of  the  Parameter 
Editors  CSCI.  The  Model  Editor  allows  the  user  to  examine  and  modify  data  in  both 
tabular  and  graphical  form  on  the  Symbolics  workstation.  In  this  way,  a  SAP  client  can 
insert  classified  data  and  can  modify  the  system  for  combat  development  purposes. 
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B.7  PROBABILITY  OF  HIT  FILES 

The  parameter  file,  hitmodels.lisp,  contains  the  probability  of  hit  tables  for  the  various 
munitions  used  by  the  SAF  Simhost  CSCL 

During  combat,  the  simhost  determines  if  a  SAF  weapon  hits  its  target.  When  a  SAF 
weapon  fires  at  a  target  the  probability  of  hit  is  determined  by  the  range,  weapon  and 
ammunition  type,  and  state  (target  aspect).  'Die  states  of  the  target  are:  partially  visible 
(hull  defilade),  fully  visible  stationary  (stationary)  and  fully  visible  moving  (moving). 

The  probability  of  hit  file  contains  five  tables: 

1  Probability  of  Hitting  All  Targets  for  25mm  Gun 

2  Probability  of  Hitting  All  Targets  for  lOSnom  Gun 

3  Probability  of  Hitting  All  Targets  for  a  Missile 

4  Probability  of  Hitting  All  Targets  for  a  23mm  AA  Missile 

5  Probability  of  Hitting  All  Targets  for  a  57mm  Rocket 

The  range  and  probability  values  of  the  hit  tables  used  by  the  SAF  Simhost  CSCI 
can  easily  be  changed  by  using  the  Model  Editor  component  of  the  Parameter  Editors 
CSCI.  The  Model  Editor  allows  the  user  to  examine  and  modify  data  in  both  tabular  and 
graphical  form  on  the  SymboUcs  workstation.  In  this  way,  a  SAF  client  can  insert 
classified  data  and  can  modify  the  system  for  combat  development  purposes. 


B.8  PROBABILITY  OF  DAMAGE  FROM  DIRECT  FIRE  FILES 

The  SAF  vehicles  and  weapons  systems  are  subject  to  catastrophic,  mobility,  and 
firepower  combat  damage  according  to  the  type  of  weapon  used,  the  impact  area,  and 
the  angle  of  incidence.  The  probability  of  damage  from  direct  fire  tables  are  located  in  the 
file  named  df_damage.Iisp. 

In  SAF  version  3.9.10  the  file,  df.damg.lisp,  is  divided  into  four  sections:  tank,  ifv, 
heio  (helicopter)  and  aiiplane.  Each  section  contains  a  probability  of  direct  fire  damage 
table  for  each  type  of  attacking  weapon.  The  types  of  attacking  weapons  are:  heatlOS, 
sabotl05,  heat25,  sabot25,  tow.missile,  hellfire_missile,  antiaircraft.missile,  small 
arms,  mine,  and  !x>mb.  The  file,  damage_map.lisp,  maps  these  weapons  to  all  those 
present  in  the  SIMNET  protocol. 

Each  of  these  direct  fire  damage  tables  contains  probability  entries  for  eight  impact 
areas.  The  impact  area  is  determined  by  both  type  of  hit  and  location  of  hit.  The  type  of 
hit  is  either  a  hull  hit  or  a  turret  hit.  The  location  of  hit  is  either  front,  side,  back,  or 
top.  Therefore,  the  eight  impact  areas  are:  hull  front,  hull  side,  hull  back,  hull  top,  turret 
front,  turret  side,  turret  back,  and  turret  top. 
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Each  probability  entry  consists  of  three  probability  tuples,  one  for  each  of  the  following 
angle  of  incidence  grouping:  0  to  30  de^ms,  30  to  60  degrees,  and  60  to  90  degrees.  The 
angle  of  incidence,  determined  from  the  direction  of  the  incoming  round,  varies  from  0  to 
90  degrees  as  the  incoming  round  moves  from  being  tangential  to  perpendicular  to  the 
iiiq>acted  side.  Each  probability  tuple  contains  three  elements;  a  probability  of 
catastrophic  damage,  a  probabiUty  of  mobility  damage,  and  a  probability  of  firepower 
damage. 

Each  configuratitMi  file  vehicle  contains  a  parameter,  df_damage_model,  whose  value 
indicates  which  section  of  df_damg.lisp  applies  to  the  vehicle.  In  SAP  version  3.9.10, 
both  the  t72  and  the  ml  vehicles  are  direct  to  use  the  tank  diiea  fire  damage 
tables.  The  bmp2,  brnpsa?,  sa9,  zsu23-4,  arcv,  m2,  hummv-stinger,  and  adat  vehicles  are 
directed  to  use  the  ifv  direct  fire  damage  tables.  The  hind,  havoc,  ah64,  and  oh58d 
vehicles  are  directed  to  use  the  helo  dii^  fire  damage  tables.  The  su25  and  alO 
vehicles  are  directed  to  use  the  airplane  direct  fire  dt^ge  tables. 

The  probability  values  of  the  direct  fire  damage  tables  used  by  the  SAP  Simhost  CSCl 
can  easily  be  changed  by  using  the  Model  Editor  component  of  the  Parameter  Editors 
CSCl.  The  Model  Editor  allows  the  user  to  examine  and  nxxlify  data  in  both  tabular  and 
graphical  form  on  the  Symbolics  workstation.  In  this  way,  a  SAP  client  can  insert 
classified  data  and  can  modify  the  system  for  combat  development  purposes. 
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B.9  PROBABILITY  OF  DAMAGE  FROM  INDIRECT  FIRE  FILES 

The  SAP  vehicles  and  weapons  are  subject  to  catastrophic,  mobility,  and  firepower 
combat  damage  according  to  the  type  of  weapon  used  and  the  range.  The  probability  of 
damage  tables  for  indirect  fire  are  located  in  the  file  named  if_daimge.lisp. 

In  SAP  version  3.9.10  the  file,  if_damg.lisp,  is  divided  into  two  sections:  tank  and  ifv. 
Each  section  cmtains  a  probability  of  direct  fire  damage  table  for  each  type  of  indirect 
fire  weapon.  The  types  of  indirect  fire  weapons  are:  bomb,  pdlS5,  vtl55,  pdl07,  vtl07, 
and  mine. 

Each  amfigmtion  file  vehicle  contains  a  parameter,  if_damage_model,  whose  value 
indicates  which  section  of  if_damg.lisp  implies  to  the  vehicle.  In  SAP  version  3.9. 10,  both 
the  t72  and  the  ml  vehicles  are  di^t^  to  use  the  tank  indirect  fire  damage  tables.  The 
bmp2,  bmpsa7,  sa9,  zsu23-4,  arcv,  m2,  hummv-stinger,  adats,  hind,  havoc,  ah64, 
ohSSd,  su2S,  and  alO  vehicles  are  directed  to  use  the  ifv  indirect  fire  damage  tables. 

The  probability  values  of  the  indirect  fire  damage  tables  used  by  the  SAP  Simhost  CSCl 
can  easily  be  changed  by  using  the  Model  Editor  component  of  the  Parameter  Editors 
CSCI.  The  Model  Editor  allows  the  user  to  examine  and  modify  data  in  both  tabular  and 
graphical  form  on  the  Symbolics  woricstation.  In  this  way,  a  SAP  client  can  insert 
classified  data  and  can  modify  the  system  for  combat  development  purposes. 


B.IO  MAPPING  FILES 

The  file,  mappings.lisp,  contains  four  sections  and  each  section  is  headed  with  a  comment 
describing  its  rules  for  use.  The  first  section  maps  numbers  to  icons  used  by  the 
workstation.  The  second  sectirm  maps  numbers  to  the  echelons  described  in  the  echelon 
files  (red_echelons.lisp  and  blue_echelons.lisp).  The  third  section  maps  numbers  to  the 
echelon-type  (also  refered  to  as  the  unit-type).  The  fourth  section  maps  the  icOT  names  of 
the  first  section  to  the  echelon-types  of  the  third  section. 

The  file,  damage_map.lisp,  m^s  the  type  of  attacking  weapon  used  in  the  combat  damage 
tables  to  all  those  present  in  the  SIMNET  protocol.  In  SAP  3.9.10  the  types  of  attacking 
weapons  are:  heatlOS,  sabotlOS,  heat25,  sabot25,  tow_missile,  hellfire_missile, 
antiaircraft.missile,  small  arms,  mine,  and  bomb. 


B.ll  MACRO  SUBSTITUTION  FILES 

Every  constant  in  the  SIMNET  6.6  protocol  has  an  entry  in  the  file,  simnet.mac.  At 
simhost  runtime,  this  file  is  read  to  convert  values  in  the  configtuaticm  files  to  the 
appropiate  SIMl^T  values.  The  name,  simnet.mac,  (an  abbreviation  for  SIMNET  macro) 
is  used  because  this  process  is  similar  to  a  macro  substitution. 

Every  constant  in  the  SIMNET  6.0  protocol  has  an  entry  in  the  file,  simnet6-0.mac.  When 
the  6.0  protocol  is  specified  at  simhost  runtime,  this  file  is  read  to  convert  values  in  the 
configi^tion  files  to  the  appropriate  SIMNET  values.  The  name,  simnet6-0.mac,  (an 
abbreviation  for  SIMNET6-0.macro)  is  used  because  this  process  is  similar  to  a  macro 
substitution. 


B-24 


BBN  Systems  and  Technologies 


SAP  Parameter  Editor  CSQ 


APPENDIX  C:  SAP  TERRAIN  FILES 

C.l  Introduction . C-2 

C.2  Polygons  File . C-3 

C.3  Quadtree  Files . C-4 

C.4  Nets  File . C-9 

C.4.1  Segment  Data . C-10 

C.4.2  Intersectitxi  Data . C-10 

C.4.3  Bridge  Data . C-12 

C.4.4  RailData . C-12 

C.5  Model  FUe . C-12 

C.6  Ground  File . C-13 

C.7  Contours  File . C-13 


BBN  Systems  and  Technologies 


SAF  Parameter  Editor  CSQ 


APPENDIX  C:  SAF  TERRAIN  FILES 
C.1  INTRODUCTION 

Within  the  SAF  project  there  is  a  requirement  for  both  a  polygonal  and  a  quadtree 
representatitm  of  terrain.  The  low  level  terrain  needed  for  SAF  vdiicle  simulation  is 
represented  by  the  polygonal  data  structure.  The  higher  level  terrain  needed  for  displaying 
terrain  to  die  commands  and  for  terrain  reasoning  is  rqiresented  by  a  quadtree  data 
structure  optimized  for  these  activities. 

The  simulation  of  the  SAF  vehicles  uses  a  terrain  carpet  built  from  a  large  number  of  small 
polygons,  in  a  format  similar  to  that  used  in  the  SIMNET  Computer  Image  Generator 
(QG).  llie  runtime  terrain  database  used  by  die  manned  simulators  cmsists  of  a  large 
number  of  polygons,  of  two  types,  which  are  optimized  to  display  quickly  when  used  with 
the  CIG  haklware.  The  terrain  polygons,  which  have  different  elevations  at  the  vertices, 
are  used  to  display  the  underlying  terrain.  Terrain  objects,  which  are  made  up  of  large 
numbers  of  in^vidual  polygons,  are  used  to  di^lay  the  terrain  specific  objects  on  the 
underlying  terrain.  The  ir^vidual  runtime  objects  are  made  up  of  a  large  number  of 
polygons  for  two  reasons.  First,  the  runtime  database  is  divided  into  lo^  modules  to  limit 
the  number  of  polygons  that  ne^  to  be  handled  at  any  one  time  by  the  QG  hardware.  This 
forces  objects  to  be  broken  up  at  these  runtime  module  boundaries.  Second,  objects  are 
broken  up  so  that  they  lie  flat  on  the  underlying  terrain  polygons.  This  large  number  of 
object  polygons  make  drawing  of  the  terrain  objects  very  slow.  Also,  reasoning  on  these 
objects  is  extremely  difficult  bKause  there  is  no  connectitai  between  the  individual 
polygcMis  of  the  same  object 

To  create  a  divoaified  data  structure  database  that  wraks  well  for  both  display  and 
reasoning,  the  terrain  model  in  the  SAF  program  processes  the  runtime  database  to  smie  the 
terrain  as  feature  arrays  with  a  quadtree  structure  of  feature  indices  into  these  feature  arrays. 
The  quadtree  terrain  database  is  object  oriented,  with  individual  terrain  objects  identified  as 
such  and  appropriate  information  about  those  objects  stored  with  them.  Also,  connectitxis 
between  objeas  are  identified.  Fen-  example,  ro^s  are  sttxed  as  individual  road  segments, 
with  attributes  such  as  road  width  and  distance.  Also,  road  network  information  is  stored 
to  determine  which  road  segments  meet  at  the  intersections.  The  ctxnbat  instructicMi  set  and 
route  planning  routines  need  to  know  about  the  torain  in  order  to  make  intelligent  decisions 
about  where  to  go  and  how  to  perfexm.  For  fast  map  drawing,  the  terrain  database  needs 
to  have  the  least  amount  of  items  to  be  drawn.  These  items  are  identified  as  to  what  type  of 
object  they  are,  in  order  to  draw  them  appropriately.  The  display  routines  use  the  qu^tree 
representation  to  paint  a  map,  at  various  scales,  onto  the  workstation  display. 
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Seva^  types  of  terrain  objects  are  stored  and  each  type  is  stored  in  a  data  structure  which 
is  optimi^  for  that  object  type.  The  four  files  that  hold  the  terrain  objects  in  the  SAF 
version  3.9.10  terrain  databa^  are  named: 

•  nets  -  This  file  stores  data  fen-  road  segn^nts,  road  intersections,  river  segments, 
river  intersections,  bridges  and  rails. 

•  models  -  This  file  stores  data  for  trees,  tree  lines,  canopies,  and  buildings. 

•  contours  -  This  file  stores  data  for  cemtour  lines. 

•  ground  -  This  file  stores  data  for  lakes,  ocean,  or  other  ground  soil  types  that  are 
not  standard  hard-packed  dirt 


The  following  types  are  used  to  describe  the  data  of  die  SAF  terrain  files: 

•  INT8  -  8  bits,  1-byte  capable  of  holding  one  character 

•  INT16  - 16  bits,  2-bytes  capable  of  holding  one  short  integer 

•  INT32  -  32  bits,  4-bytes  capable  of  holding  one  integer 

When  an  array  is  described,  the  number  of  elements  of  the  specified  type  will  be  enclosed 
in  brackets  following  the  item  name.  For  example,  the  description,  "points[num_points]", 
means  that  the  item,  points,  is  an  array  of  elements.  The  niunber  of  elements  in  the  array  is 
specified  by  the  value  of  the  item,  num_points. 


C.2  POLYGONS  FILE 

The  polygons  file  represents  the  terrain  as  a  carpet  of  polygons  which  have  different 
elevations  at  the  vertices.  The  polygonal  data  structure  is  used  to  determine  the  support 
polygon  of  the  ground  vehicles  frem  which  can  be  derived  the  maximal  accelerations  and 
the  orientation  of  the  vehicles.  Additionally,  the  polygons  file  is  used  by  the  intervisibility 
code  to  determine  if  two  vehicles  have  a  line  of  sight  between  them. 
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C.3  QUADTREE  FILES 

There  are  two  quadtree  files:  a  quadtree  full  fite  and  a  quadtree  leaf  file.  Each  file  contains  a 
quadtree  structure  which  divides  the  terrain  database  into  500  square  meter  terrain  patches, 
b  the  quadtree  fiill  file,  each  node  of  the  quadtree  has  an  index  into  what  is  called  a  feature 
array.  The  feature  array  contains  pointers  into  the  data  structures  for  die  actual  terrain 
features  within  that  quadnode's  terrain  patch.  In  the  quadtree  leaf  file,  only  leaf  nodes  of 
die  quadtree  contain  indices  into  die  arrays  data  structures  holding  the  actu^  terrain 
features. 

These  two  quadtree  files  allow  representadon  of  objects  at  different  levels  of  fidelity  so  that 
reasoning  can  be  performed  quicUy  over  large  areas  of  the  tenain  and  then  focused  in  on 
smaller  areas  for  more  exact  reasoning.  Also,  large  areas  of  the  terrain  can  be  displayed  at 
a  lower  fidelity  to  speed  up  drawing  time.  Using  the  quadtree  full  file,  abstract  d^ 
structures  can  be  stored  at  higher  levels  of  the  quadtree  since  a  terrain  feature  that  spans 
multiple  nodes  is  stored  only  with  the  one  node  that  is  high  enough  in  the  quadtree  to 
contain  the  entire  feature.  In  the  quadtree  leaf  file,  when  a  feature  is  present  in  more  than 
one  quadnode,  the  index  is  duplicated  in  those  quadnodes. 

The  quadtree  representation  provides  the  data  organization  to  limit  the  search  space.  Given 
an  area  of  interest,  only  the  feature  indices  of  the  quadtree  nodes  that  are  partially  or  totally 
within  that  area  need  to  be  accessed. 

Figure  1  shows  the  structure  of  the  quadtree.  Each  parent  node  has  four  child  nodes, 
one  each  to  represent  the  division  of  the  terrain  into  a  NorthEast,  SouthEast,  SouthWest, 
and  Northwest  quadrant.  Each  node  of  the  quadtree  has  a  field  to  hold  an  index  into  the 
feature  array  for  that  node.  Each  node  also  a  field  which  serves  as  a  child  node  pointer; 
it  contains  a  zero  when  this  node  is  a  leaf  node  or  else  it  ccxitains  an  index  to  the  node's 
first  (NorthEast  quadrant)  child  node. 
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Terrain  is  divided  into 
four  quadrants: 


NW 

SW 


CO 


CO 
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The  header  of  the  quadtree  file  contains  the  following  items: 
nm  TYPE  COMMENT 


size 

INT32 

resolution 

INT32 

X 

INT32 

y 

INT32 

num.nodes 

INT32 

major_versicMi 

INT32 

max_x 

INT32 

max _y 

INT32 

fill_type 

INT8 

padding 

INT8 

num_chars_name 

INT32 

num_chars_UTM_SW 

INT32 

num_chars_lJTM_NE 

INT32 

name 

null-terminated 
string,padded  to 
a  short  boundary 

UTM_SW 

null-terminated 
string,padded  to 
a  short  boundary 

UTM_NE 

null-terminated 
string,padded  to 
a  short  boundary 

the  size  in  meters  of  the  largest  quadnode  in  the  Ele 
the  size  in  meters  of  the  sinallest  quadnode  in  the 
file 

X  coordinate  of  SW  comer  of  this  terrain  database 

Y  coordinate  of  SW  comer  of  this  terrain  database 
number  of  quadtree  nodes  in  this  file 

major  version  number  of  this  database,  for 
exan^le,  0311 

X  coordinate  of  NE  comer  of  this  terrain  database 

Y  coordinate  of  NE  comer  of  this  terrain  database 
a  value  of  1  indicates  that  this  is  a  leaf  filled 
quadtree  and  a  value  of  0  indicates  that  this  is  a  full 
filled  quadtree 

unused 

number  of  characters  making  up  name 
number  of  characters  making  up  irrM_SW 
number  of  characters  *^2king  up  IJTM_NE 
the  name  of  this  database,  for  example,  Knox 


the  UTM  cocndinate  of  the  SW  cwner  of 

the  database,  fcr  example,  ES450550  for  Knox 

database 

the  UIM  coordinate  of  the  NE  comer  of  the 
database,  for  example,  FT200050  for  Knox 
database 
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In  the  quadtree  representation,  each  patch  of  terrain  is  represented  by  a  quadnode 
attaining  the  following  items: 


ITEM 


T£Eg  COMMENT 


imn_x 

imn_y 

max_x 

max_y 

feature.index 

child_index 


INT32  X  coordinate  of  SW  comer  of  this  quadnode 

INT32  Y  coordinate  of  SW  comer  of  this  quadnode 

INT32  X  coordinate  of  NE  comer  of  this  quadnode 

INT32  Y  coordinate  of  NE  comer  of  this  quadnode 

INT32  index  to  the  feature  array  which  contains  pointers  to 

the  objects  contained  in  this  patch  of  terrain 
INT32  index  to  the  child  iKxle  or  0  fcx'  a  leaf  iKxie 


Each  element  in  the  feature  array  contains  the  fc^owing  pointers: 


ITEM 

TYPE 

COMMENT 

water_indicies 

array  of  INT32 

the  list  of  water  segment  indices  of  this  quadtree 
node.  The  first  element  in  the  list  tells  the  total 
number  of  indices  in  the  list.  Water  segment  data  is 
stored  in  the  Nets  File. 

water_int_indicies 

array  of  INT32 

the  list  of  water  intersection  indices  of  this  quadtree 
iKxk.  The  first  element  in  the  list  tells  the  total 
number  of  indices  in  the  list  Water  intersection 
data  is  stored  in  the  Nets  File. 

road_indicies 

array  of  INrr32 

the  list  of  road  segnrent  indices  of  this  quadtree 
iKxie.  The  first  element  in  the  list  tells  Ae  total 
number  of  indices  in  the  list.  Road  segment  data  is 
stored  in  the  Nets  File. 

road_int_indicies 

array  of  INT32 

the  list  of  road  intersection  indices  of  this  quadtree 
node.  The  first  element  in  the  list  tells  the  total 
number  of  indices  in  the  list  Road  intersection  data 
is  stored  in  the  Nets  File. 

bridge_indicies 

array  of  INT32 

the  list  of  bridge  indices  of  this  quadtree  node.  The 
first  element  in  the  list  tells  the  total  number  of 
indices  in  the  list.  Bridge  data  is  stored  in  the  Nets 
File. 

rail_indicies 

array  of  INT32 

the  list  of  bridge  indices  of  this  quadtree  node.  The 
first  element  in  the  list  tells  the  total  number  of 
indices  in  the  list.  Bridge  data  is  stcxed  in  the  Nets 
FUe. 

lake_indicies 

array  of  INT32 

the  list  of  lake  indices  of  this  quadtree  node.  The 
first  element  in  the  list  tells  the  total  number  of 
indices  in  the  list  Lake  data  is  stored  in  the 

Ground  File. 

canopyjndicies 

array  of  INT32 

the  list  of  tree  canopy  indices  of  this  quadtree  node. 
The  first  element  in  die  list  tells  the  total  number  of 
indices  in  the  list  Tree  canopy  data  is  stOTed  in  the 
Models  File. 

tree_indicies 

array  of  INT32 

the  list  of  tree  indices  of  this  quadtree  node.  The 
first  element  in  the  list  tells  the  total  number  of 
indices  in  the  list.  Tree  data  is  stored  in  the  Models 
File. 
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building_indicies 

array  of  INT32 

the  list  of  building  indices  of  this  quadtree  node. 
The  first  element  in  the  list  tells  the  total  number  of 
indices  in  the  list.  Building  data  is  stored  in  the 
Models  File. 

• 

contour_indicies 

array  of  INT32 

the  list  of  contour  line  indices  of  this  quadtree 
node.  The  Brst  element  in  the  list  tells  the  total 
number  of  indices  in  the  list.  Contour  line  data  is 
stored  in  the  Contours  File. 
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C.4  NETS  FILE 

The  nets  file  is  used  for  road  and  water  networks.  In  the  road  network.the  road  segment 
objects  are  the  segments  that  run  between  the  road  intersection  objects.  Each  road  segment 
object  c(xitains  a  list  of  points  specifying  the  midline  endpoints  of  each  leg  within  that 
segment.  The  width  of  each  ro^  segment  and  the  distance  along  each  road  segment  are 
also  stored  in  the  segment  objects.  The  road  intersectitxi  data  maps  to  road  segment  objects 
via  a  list  of  indices  identifying  the  road  segiwnts  connected  to  the  intersection.  The  road 
netwOTk  can  be  used  to  fiiid  the  minimum  distance  paths  between  two  points,  and  the 
midline  points  can  be  used  to  specify  the  route  alcmg  those  road  segments.  Likewise,  the 
array  of  water  segment  objects  identifies  the  sections  of  each  river  ^at  run  between  the 
water  intersections. 

Figiue  2  shows  some  segment  and  intersection  objects.  Segment  1,  the  stretch  of  road 
between  intersection  3  ai^  intersection  1,  has  3  points  to  it  The  coordinates  of  those 
points  are  labeled  (X1,Y1),  (X2,Y2),  and  (X3,Y3). 


Road  segments  are  broken  at  intersection  points.  There  is  always  an  intersection  at  the  end 
of  a  road  segment  even  when  the  road  doesn't  connect  to  another  segment.  Bridges  are 
always  their  own  segment,  so  there  is  always  an  intersection  at  each  end  of  a  bridge,  as 
shown  by  segment  5  in  Figure  2. 
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The  nets  file  contains  arrays  of  road  segment,  road  intersection,  water  segment,  water 
intersection,  bridge  and  rail  data.  The  format  of  each  of  these  arrays  is  describe  below. 


C.4.1  Segment  Data 


Each  segment  (road  segment  or  river  segment)  element  OMitains  the  following  items; 


ITEM 

TYPE 

num_pts 

INT16 

coordinates[num_pts] 

INT32 

width 

INT16 

width_endl 

INT16 

width_end2 

INT16 

inti 

INT16 

int2 

INT16 

x_min 

INT32 

y_min 

INT32 

x_max 

INT32 

y_max 

INT32 

fordable 

INT8 

bridge 

INT8 

C.4.2  Intersection 

Data 

COMMENT 

number  of  points  that  make  up  the  segment 
the  list  of  coOTdinates  for  the  points  of  the  segment 
width  of  the  segment 

used  to  provide  the  tapered  end  of  a  water  segment 
used  to  provide  the  tapered  end  of  a  water  segment 
index  to  an  intersection  point  at  one  end  of  the 
segmrat 

index  to  an  intersecticm  point  at  opposite  end  of  the 
segment 

X  coordinate  of  point  that  is  farthest  West 

Y  coOTdinate  of  point  that  is  farthest  South 
X  coordinate  of  point  that  is  farthest  East 

Y  coordinate  of  point  that  is  farthest  North 

for  a  water  segment,  is  segment  fordable?,  yes  or 
no 

for  a  road  segment,  is  segment  a  bridge?,  yes  or  no 


Fig^e  3  shows  the  intersection  data  of  a  road  netwOTk.  Each  intersection  (road  intersection 
or  river  intersection)  has  at  least  one  intersecticm-segment  index  pair  associated  with  it 
These  identify  the  segments  and  intersections  that  connect  to  the  intersection  point. 
Intersection  1  connects  to  intersection  2  via  segment  2,  to  intersection  3  via  segment  1,  to 
intersection  5  via  segment  4 ,  and  to  intersection  4  via  segment  3. 


Each  intersection  (road  intersection  or  river  intersection)  element  contains  the  following 
iteiTis: 


ITEM 

TYPE 

COMMENT 

num_pairs 

INT16 

number  of  intersection-segment  index  pairs 

pairs[num_pairs] 

INTI  6 

the  list  of  intersection-segment  index  pairs 

X 

INT32 

X  coemlinate  of  intersectitMi  point 

y 

INT32 

Y  coordinate  of  intersection  point 

bridge 

INT16 

index  to  bridge  object  if  this  intersection  is  at  one 
end  of  a  bridge 
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Figure  3:  Intersection  Data 
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C.4.3  Bridge  Data 


Each  bridge  is  identified  as  a  separate  object  to  allow  more  precise  road  following  routines 
to  be  run  when  a  vehicle  is  crossing  a  bridge,  as  well  as  to  ^ow  bridges  to  be  identified  as 
a  targets.  Each  element  of  the  bridge  array  ctxitains  the  foUowing  items: 


ITEM 

TYPE 

COMMENT 

num_points 

INT16 

number  of  points  making  up  bridge 

points[num_points] 

INT32 

the  coordinates  of  the  bridge  points 

X 

INT32 

X  cooxlinate  of  the  center  of  the  bridge 

y 

INT32 

Y  coordinate  of  the  center  of  the  bridge 

width 

INT16 

width  of  bridge  in  meters 

C.4.4  Rail  Data 

Currently  railroad  tracks  are  used  only  for  display.  Each  element  of  the  rail  array  contains 
the  following  items: 


ITEM 

TYPE 

COMMENT 

num_points 

INTI  6 

number  of  points  making  up  the  railroad  tracks 

points[num_points] 

INT32 

the  coordinates  of  the  points  making  up  the 

railroad  tracks 

widtli 

INT16 

width  of  tracks  in  meters 

C.5  MODEL  FILE 

The  model  file  is  an  array  for  trees,  tree  lines,  tree  canopies,  and  cultural  objects  (such  as 
buildings).  Tree  lines  are  simply  lists  of  points  along  the  tree  line  or  a  single  point  to 
specify  a  single  tree.  Tree  canopies  arc  stored  as  polygons.  Cultural  objects  arc  stored  as 
bounding  boxes,  where  each  object  has  a  location,  width,  and  breadth. 

Each  element  of  the  array  contains  the  following  items: 


ITEM 

TYPE 

COMMENT 

num_points 

INT16 

number  of  points  making  up  the  model 

points[num_points] 

INT32 

the  coordinates  of  the  n^el  points 

x_min 

INT32 

X  coordinate  of  point  farthest  West 

y_min 

INT32 

Y  coOTdinate  of  point  farthest  South 

x_max 

INT32 

X  coordinate  of  point  farthest  East 

y_max 

INT32 

Y  coOTdinate  of  point  farthest  North 

model_type 

INT16 

identifies  the  mt^el  as  a  tree,  treeline,  tree  canqiy, 
or  building 

height 

INT16 

height  in  meters 

impenetrable 

INT8 

can  this  object  be  driven  through?  yes  or  no 
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C.6  GROUND  FILE 


The  ground  file  is  an  array  fra*  lakes,  oceans,  or  areas  of  soil  that  are  not  standard  hard- 
packed  dirt.  Each  element  of  the  array  contains  the  following  items: 


ITEM 

TYPE 

COMMENT 

num_4X)ints 

INT16 

number  of  points  making  up  the  area 

points[numj)oints] 

INT32 

the  coordinates  of  the  area  points 

x_min 

INT32 

X  cotxdinate  of  point  farthest  West 

y_min 

INT32 

Y  cocH’dinate  of  point  farthest  South 

x_max 

INT32 

X  coordinate  of  point  farthest  East 

y_max 

INT32 

Y  coordinate  of  point  farthest  North 

level 

INT16 

identifies  level  of  nested  area.  The  level  is  0  for  the 
outer  boundary,  1  for  an  area  nested  inside  a  level  0 
area,  and  2  for  an  area  nested  inside  a  level  1 ,  etc. 
Therefore,  an  island  in  a  lake  would  be  a  level  1, 
and  a  pond  on  that  island  would  be  level  2. 

poly_type 

INTI  6 

used  to  identify  soil  type  of  area  (water,  muck, 
hard  soil  etc.) 

C.7  CONTOURS  FILE 

Contour  lines  are  lists  of  points  with  an  elevation  value,  which  are  simply  drawn  as  lines. 
Contour  lines  can  be  obtained  for  a  range  of  intervals.  The  interval  of  the  contour  lines 
displayed  depends  on  the  scale  of  the  map  being  displayed,  so  that  for  larger  scales  the 
contour  interval  is  greater  than  for  smaller  scales. 


The  contour  file  is  an  array  for  contour  lines.  Each  element  in  the  array  contains  the 
following  items: 


ITEM 

TYPE 

COMMENT 

num_points 

INT16 

number  of  points  making  up  the  contour  line 

points[num_points] 

INT32 

the  coordinates  of  the  contour  line  points 

x_min 

INT32 

X  coordinate  of  point  farthest  West 

y_min 

INT32 

Y  coordinate  of  point  farthest  South 

x_max 

INT32 

X  coordinate  of  point  farthest  East 

y_max 

INT32 

Y  coordinate  of  point  farthest  North 

type 

INT16 

identifies  the  object  as  a  contour  line 

height 

INT16 

elevation  in  meters  above  sea  level 

impenetrable 

INT16 

not  used 
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